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Welcome! 


Welcome to SunOS 4.1.2. This 
preface describes how this 
manual is organized, with brief 
descriptions of each section. 
The manual has five parts: 


e Introduction 
e Features 


e Installation and System 
Configuration 


e Open Issues 


e Appendixes 


Introduction 


What is in this manual? What 
should you do before installing 
this release? Part 1 has one 
chapter, which contains the fol- 
lowing sections: 


e Release Compatibility 


e Workstation and Machine 
Architecture Terminology 


e Getting Help 
e Guide to Publications 


e Documentation Conven- 
tions 


Features 


What is new in SunOS 4.1.2? 
Part 2 contains detailed descrip- 
tions of all new features and 
changes. It also describes all 
bugs that have been fixed since 
SunOS 4.1.1 Rev B. This part 
contains the following chapters: 


New Software Features 
e About Openwindows 
e New Hardware Features 


e Open Boot PROM 2.0 and 
Hierarchical Device Nam- 
ing 


e Bugs Fixed in SunOS 
4.1.2 


Installation and 
System 
Configuration 


Use Part 3 along with other ins- 
tallation documents when instal- 
ling SunOS 4.1.2. This part 
contains the following chapters: 


e Installation Notes and 
Warnings 


Notes and warnings about 
installing unbundled pro- 
ducts. 


e System Configuration 


Hints for kernel 
configuration and for 
improving system perfor- 
mance. 


Open Issues 


Part 4 contains the latest infor- 
mation on this SunOS release. 
Be sure to read this material, 
which is separate from the 
Release Manual in the Release 
Minibox, and be sure to insert it 
behind the Open Issues tab. This 
part contains the following 
chapters: 


e Late-Breaking News 
Includes the latest news 
about SunOS 4.1.2 


e Known Problems 
Describes any known prob- 
lems in the release 


Appendixes 


Refer to this part for detailed 
information about: 


e Documents Available for 
Use with SunOS 4.1.2 


e Addendum to Writing 
Device Drivers 


e Sundiag Version 2.3 for 
SunOS 4.1.2 


e X/Open Conformance 
Statement for SunOS 4.1 
Products Receiving the 
XPG3 Component Brand 
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Part 1 — Introduction 


Read Part | to get a quick introduction to the release, including pointers to other 
parts of the Release Manual and to other documentation. Read Part 2, Features, 
for a detailed description of the release, and Parts 3 and 4, Installation and Open 
Issues, for the latest information about installing and using the release. 


Chapter 1, “Introduction,” includes the following sections: 


Release Compatibility 

Workstation and Machine Architecture Terminology 
Getting Help 

Guide to Publications 


Documentation Conventions 


Part 1 — Introduction — Continued 


1.1. Release Compatibility 


SunOS 4.1.2 Binary 
Compatibility with SunOS 4.1 


Introduction 


Welcome to SunOS™ 4.1.2. This software release includes the following: 
e Support for the new SPARCsystem 600MP series of systems 


e Anincremental software upgrade program (from SunOS 4.1.1 and 4.1.1 Rev 
B) 


e Incorporation of SunOS 4.1.1 Rev B and SunOS 4.1.1 GFX releases 
e More than 200 SunOS bug fixes 


SunOS 4.1.2 is released on all SPARC™ platforms (CD-ROM only), and is fully 
compatible with SunOS 4.1.1 and SunOS 4.1.1 Rev B. See “New Software 
Features” for a detailed description of the new software features and “New 
Hardware Features” for a detailed description of the newly-supported hardware. 


Be sure to read the material in the Open Issues package from the SunOS Release 
Minibox before proceeding with the installation or upgrade; this package, 
comprised of Chapter 9, “Late-Breaking News,” and Chapter 10, “Known Prob- 
lems,” may contain material that corrects or supersedes information in this 
manual. Insert the Open Issues package into this manual behind the Open Issues 
tab. 


In addition, Desktop SPARCsystem owners may want to consult the appropriate 
Desktop SPARC Installation Guide and other Sun documentation during the 
installation. : 


SunOS 4.1.2 is fully binary compatible with SunOS 4.1 and subsequent 4.1.X 
releases; all applications written for SunOS 4.1, SunOS 4.1.1, or SunOS 4.1.1 
Rev B will run on the SunOS 4.1.2 release without change. 


User executables (including shared libraries), sources, and object files from 
SunOS 4.1, SunOS 4.1.1, or SunOS 4.1.1 Rev B should move to SunOS 4.1.2 
with no change. This includes many Sun and third—party unbundled products. 
The rare exceptions to this are programs, whether in source, object, or executable 
form, that depend upon the internal implementation of the kernel and its data 
structures. Programs that use the kvm library are likely to be in this class. 
Although many of these programs will still run, the data they access through the 
library may have changed in ways that can affect the functioning of the program. 
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Binary Compatibility with 
SunOS 4.0.X 


In addition, programming that modifies the implementation of the system, espe- 
cially kernel extensions or modifications, may require some conversion. Device 
drivers that use interface routines published in the Writing Device Drivers 
manual should require no modification. However, all kernel modifications 
should be inspected to verify that the aspects of system implementation they rely 
upon have not been altered. See Appendix B for more about device drivers. 


Lastly, a bug fix in the 1ink-editor provided with 4.1.2 may reveal previ- 
ously masked errors with incorrectly constructed shared libraries. These will 
manifest themselves as references to undefined symbols. See “Link-editor Bug 
Fixes” in Chapter 2 for more detail. 


User executables (including shared libraries), sources, and object files from 4.0.X 
releases should move to SunOS 4.1.2 with no change. This includes many Sun 
and third party unbundled products. There are exceptions to this that should, in 
practice, be encountered rarely. These are programs (in any of source, object, or 
executable forms) that: 


e Depend upon the internal implementation of the kernel and its data struc- 
tures: 


e Depend upon the object file format in a way that can be confused by extra 
information now appearing at the end of some object files in support of 
#ident directives in C source programs; 


e Rely upon implementation attributes, such as the location, existence, or for- 
mat of certain files not documented as part of the system’s programming 
interface (such as temporary files created by library functions or utilities). 


Programs that use the kvm library are likely to be in the first class of programs 
described above; although the programs may still function, the data they access 
through the library may have changed in ways that will affect the function of the 
program. Examples of such data include the proc and user structures of the 
system. 


Further, programming that modifies the implementation of the system, in particu- 
lar kernel extensions or modifications, may require some conversion. Most 
drivers should work simply through recompilation, although other kinds of 
changes should be inspected to verify that whatever aspect of the system imple- 
mentation they rely upon for their operation has not been altered. 


Note that while it is possible, as always, to move earlier programs (their sources, 
objects, and executables) forward to SunOS 4.1.2, it is not possible to move 
SunOS 4.1, 4.1.1, 4.1.1 Rev B, or 4.1.2 programs back to SunOS 4.0.X or earlier 
releases. In SunOS 4.1, 4.1.1, 4.1.1 Rev B, and 4.1.2, this extends to newly 
created filesystems, which incorporate updates from the Berkeley 4.3 BSD 
“Tahoe” release that change the on-disk format of the filesystem. Such filesys- 
tems cannot be directly connected to pre-4.1 systems, though network access to 
them is unaffected by this change, and tapes made via dump and tar and similar 
utilities are also unaffected. 
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1.2. Workstation and 
Machine Architecture 
Terminology 


Application and Kernel 
Architecture 


Since SunOS 4.0.3, an important distinction has been made between the applica- 
tion architecture and the kernel architecture of a machine. In this and other 
documents, the distinction is frequently used in discussing workstation features 
and installation procedures. 


Every Sun system has an application architecture and a kernel architecture. 
Application architecture refers to the way in which systems interpret the binary 
code generated by application software. Two systems have the same application 
architecture if they can both run the same application binaries. Kernel architec- 
ture refers to the hardware-specific portion of a SunOS kernel. Two systems 
have the same kernel architecture if the same SunOS kernel will run on both of 
them. 


SunOS 4.1.2 supports only the sun4 application architecture (Sun-4, Sun-4c, 
Sun-4m). (Application and kernel architectures are identified by “sun” in lower 
case letters followed without a space by “3” or “4” and, optionally, a letter — 
“sun4c,” “sun4m,” “sun3x”.) Sun-4, Sun-4c, or Sun-4m servers running 4.1.2 
will fully support Sun-3 clients running SunOS 4.1, 4.1.1, or 4.1.1 Rev B. 


99 66 


All systems with sun4 application architecture are built around Sun’s SPARC 
processor. All SPARCsystems can run the same application binaries. Similarly, 
application binaries that run on one sun3 system will run on all other sun3s. 
However, application binaries generated on a SPARCsystem will not run on a 
sun3 system. 


Not all systems with sun4 application architecture have the same kernel architec- 
ture. For example, the SunOS kernel that runs on a SPARCstation 1 or 
SPARCstation 2 will not run on a SPARCstation 470 nor SPARCserver 490, nor 
will it run on SPARCsystem 600MP series machine. Both the SPARCstation | 
and SPARCstation 2 have sun4c kernel architecture. Systems such as the 
SPARCserver 490 and SPARCstation 470 have sun4 kernel architecture, and 
SPARCsystem 600MP series machines have sun4m kernel architecture. 


There are also two separate kernel architectures corresponding to sun3 applica- 
tion architecture: sun3x kernel architecture and sun3 kernel architecture. 


In commands and screen examples, this and other documents may refer to 
machine architectures as a-arch (application architecture) and k-arch (kernel 
architecture). These are often combined as a-arch.k-arch pairs, for example: 
sun4.sun4c. The following table shows application and kernel architectures for 
Sun systems. 
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1.3. Getting Help 


Table 1-1 


System Architectures and Machine Names 


Sun-4/100 & Sun-4/200 series sun4 sun4 
SPARCsystem 300 and 400 series 


SPARCstation 1, SPARCstation 1+, SPARCstation 2, sun4 sun4c 
SPARCstation IPC, SPARCstation IPX 

SPARCstation SLC, SPARCstation ELC 

SPARCserver 1, SPARCserver 1+ 

SPARCserver 2, SPARCserver IPC, SPARCserver SLC 


SPARCsystem 600MP series 


Sun-3/50, Sun-3/60, Sun-3/75, Sun-3/100 series, sun3 sun3 
Sun-3/200 series 


Sun-3/80, Sun-3/400 series 


If you have problems installing or using SunOS 4.1.2, call Sun Microsystems 
with the information outlined below. In the United States you can call 1-800- 
USA-4-SUN; outside the U.S., contact your local Sun Answer Center or your 
Sun sales representative for assistance. 


You Will Need to Provide the Following Information: 
e Your name and electronic mail address (if any) 

e Your company name, address, and phone number 

e The model and serial number of your workstation 


e Additional information provided by the showrev(8) command (described 
in Chapter 2 of the Release Manual and in the man page for showrev(8). 


— your system’s hostname 

— hostid 

— kernel and application architecture 
— SunOS release number 

— kernel revision 


e Any information that may help to diagnose the problem. 


Call your sales representative if you have questions about Sun support services or 
your shipment. 
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1.4. Guide to Publications 


1.5. Documentation 
Conventions 


.cshrc Could Be 
-profile 


Type Styles 


Boxes 


If you have a new Sun system or if you have been running a release prior to 
SunOS 4.1, you should have available the full SunOS 4.1.X set of Sun software 
manuals. Two boxes in the set are of particular importance for installing and 
running this release: the SunOS Release Minibox and the OpenWindows End 
User’s Manuals. 


Note that the Release Minibox is the only box of the full SunOS 4.1.X set that 
changed between SunOS 4.1.1 and SunOS 4.1.1 Rev B, and again between 
SunOS 4.1.1 Rev B and SunOS 4.1.2. In addition to the Release Manual, the 
Release Minibox contains Installing SunOS 4.1.2 System Software, with detailed 
instructions for performing a custom installation of SunOS 4.1.2, a quick installa- 
tion of a predefined version of SunOS 4.1.2 on a standalone workstation, or an 
upgrade of a SunOS 4.1.1 or 4.1.1 Rev B system to SunOS 4.1.2. 


For a description of the manuals provided in the full SunOS 4.1.X set, other than 
those mentioned above, see Appendix A. 


The following documentation conventions are used in this manual. 


In most cases, whenever . cshrc is mentioned in this manual, . profile may 
be substituted if you are using the Bourne shell. 


This manual uses different type styles, or fonts, to distinguish between informa- 
tion you type from the keyboard, information the system displays, and variables 
(items that must be replaced by a value). 


e listing 


Represents a system response that is displayed on your monitor or terminal 
screen. Listing font is also used for literal values (such as the names of files 
or utility programs) and for file listings and session output. 


e bold listing 
Represents characters you type from the keyboard. 
e italic 


Represents variables, for which you must substitute values. Also used for 
emphasis, particularly when introducing new terms. 


Boxes are used to display information as it appears on your video display. 


e Unshaded boxes represent screen displays, system responses, or file listings. 
They do not contain entries or responses made by a user. 
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MS 


standard daemons: update cron. 
starting network daemons: inetd printer. 
Sat Mar 17 13:40:15 PDT 1990 


gemini login: 


e Gray boxes represent a dialog between you and your workstation. Your 
entries are shownin bold listing font, system responses are shown 
inregular listing font. 


Enter name of client machine: opusone 
Enter name of server: fourfox 


e Exploding Workstation 


Marks information that it is imperative for you to read. If you skip over this 
material, you may damage your system or jeopardize the installation. 


e Pointing Hand 


Points to information that requires close attention. 
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Part 2 — Features 


Part 2 tells you what is new about SunOS 4.1.2. It includes the following 


chapters: 

e Chapter 2, “New Software Features” 

e Chapter 3, “About OpenWindows” 

e Chapter 4, “New Hardware Features” 

e Chapter 5, “Open Boot PROM 2.0 and Hierarchical Device Naming” 
e Chapter 6, “Bugs Fixed in SunOS 4.1.2” 


Part 2 — Features — Continued 


2.1. General Software 
Changes 


Sunupgrade for Upgrading to 
SunOS 4.1.2 


Graphics Support and Fixes 


Quicker File System Checks 


New Software Features 


SunOS 4.1.2 includes the following software enhancements: 
e SPARCsystem 600MP series systems support 


e Software upgrade utility (described in Installing SunOS 4.1.2 System 
Software) 


e Support for OpenWindows Version 2 and Version 3 (described in Chapter 3) 
e Support for a number of graphics devices 

e Quicker file system checks during reboot 

e Support for Rock Ridge file system on a CD-ROM 

e Availability of BSD 4.3 malloc 

e link-editor bug fixes 


e 200+ bug fixes, including fixes for graphics devices 


Software changes other than those supporting SPARCsystem 600MP series sys- 
tems are described below; SPARCsystem 600MP series changes are described in 
the following section. 


SunOS 4.1.2 includes sunupgrade for upgrading from SunOS 4.1.1 or SunOS 
4.1.1 Rev B. See “Upgrading to SunOS 4.1.2” in Installing SunOS 4.1.2 System 
Software for a complete description of the upgrade procedure. 


SunOS 4.1.2 incorporates all functionality and fixes from the 4.1.1-GFX Rev. 1 
and 4.1.1-GFX Rev.2 releases. This includes Sun-4c support for the GS, GT, and 
GXplus graphics accelerator boards and the TC frame buffer, plus Sun-4 support 
for the previously-unbundled VX graphics accelerator board, and Sun-4m sup- 
port for the single-slot GX graphics accelerator and MGI frame buffer. 


SunOS 4.1.2 includes the functionality of Sun QuickCheck 2.0, which was form- 
erly an unbundled product. Basically, fsck runs more quickly because the code 
has been rewritten to speed up file system checking, and because file systems are 
checked periodically (usually once every 30 seconds), and those marked as 
“clean” or “stable” are not checked when fsck is run in “preen” mode, and dur- 
ing reboot. The superblock of each file system contains a "clean flag" that is set 
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Rock Ridge File System 
Supported on CD-ROM 


BSD 4.3 malloc Available 


2.2. Link-editor Bug Fixes 


whenever the file system is known to be in a stable state (following a sync, for 
example). 


See the man pages for fsck(8), fstab(5), dumpfs(8), and quotacheck(8) 
for details. 


Sun’s hsfs file system (ISO 9660) now supports the Rock Ridge file system 
extensions. This will allow any Rock Ridge CD-ROM to look like full UNIX file 
systems, with long file names, case sensitivity, symbolic links, Block and Char- 
acter devices, and other UNIX file system features. The only file system exten- 
sion it does not support is writing to the CD-ROM file system itself. 


By default, when malloc () is invoked, the Sun version, found in 1 ibc, is run. 
This version of malloc () is more efficient in space than the BSD 4.3 version 
of the command, but it is not as efficient in speed. 


The BSD 4.3 version of malloc(),realloc() and free() which are 
optimized for speed rather than space,are available in 
/usr/1ib/libbsdmalloc.a. For programs where memory usage is less of 
an issue than execution speed, use the BSD 4.3 versions of malloc(), real- 
loc() and free() by explicitly compiling your programs with the - 
Bstatic -lbsdmalloc flags. 


The malloc(),realloc(),and free() routinesin Libbsdmalloc.a 
are defined like the 1ibc versions: 


char *malloc(size) 
unsigned size; 


int free(ptr) 
Char *per: 


char *realloc(ptr, size) 
Char *prrs 


Note the following caveats about 1ibbsdmalloc: 


e Compiled binaries will not be SCD/ABI-compliant (because sbrk (), 
which is not in the ABI, is called) 


e Other malloc-related routines defined in 4.X, such as calloc(), 
memalign,mallopt(), and mallinfo(), will not work 
with libbsdmalloc. 


A number of bugs have been fixed in both the static and dynamic link editors. 
All of these fixes have been previously available in patches to /usr/bin/1ld 
and /usr/1ib/1d.so; the SunOS 4.1.2 editions of these completely super- 
sede all SunOS 4.1 and SunOS 4.1.1 patches. See Chapter 7 for instructions for 
installing language patches. 
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In almost all cases, these changes simply cause the loader(s) to perform in accor- 
dance with the behaviors specified in the manuals; there are no enhancements or 
other functional changes as a result of these repairs. 


However, one of the repairs corrects a problem (Bug ID 1019004) and reveals 
bugs in other parts of the system — bugs previously masked by the incorrect 
behavior of the loader. Another repair (to Bug ID 1052428) restricts the behavior 
of the dynamic loader library search algorithm for set -user- or set - 
group-id programs. Both of these are discussed in more detail below. 


As described above, the fix repairing bug 1019004 (“assert definitions can fail to 
report undefined symbols") can reveal other problems previously masked by the 
bug. Specifically, this bug allowed the construction of programs that silently per- 
mitted inclusion of shared libraries having unresolved references. The bug fix 
makes the link editing of programs using such libraries now report errors where 
previously the link editing operation appeared to have completed successfully. 


In many cases, particularly in the case of affected libraries in Sun products, the 
unresolved references were never actually used. Thus no real problem ever 
appeared, even though such libraries are, strictly speaking, incorrectly con- 
structed. However in other cases, such as for users reporting 1019004, the failure 
to report the unresolved reference permitted users to believe they had correct pro- 
grams, only to find out that they were not correct when, during execution, the 
dynamic link editor would suddenly report the unresolved reference. 


This can manifest itself with various Sun libraries in the -Bdynamic binding 
mode (the default), as follows: 


e Sun FORTRAN: if a program uses the 1ibF77 library, but is not built as a 
FORTRAN program (1.e., not linked with an £77 command), you can expect 
to see an undefined symbol reference for MATN_. 


e Sun Pascal: if a program uses the Pascal library, but is not built as a Pascal 
program (i.e., not linked with a pc command), you can expect to see an 
undefined symbol reference for program. 


e Sun PHIGS: you can expect to receive an undefined symbol reference to 
phg_sin_set_no_input_cursor. 


e Sun Modula-2: Ifa Modula-2 program is linked dynamically it requires that 
libtermcap also be linked. 


Note that using a FORTRAN or Pascal main program will not produce diagnos- 
tics; this will happen only in the special cases of using their libraries from (for 
example) a C main program. 


In all cases where the error occurs, you can safely ignore the error if it is the only 
undefined symbol reported. Your executable will be marked as “executable”, but 
the linker will return a non-zero error, thus causing makefiles to terminate abnor- 
mally. A workaround for this problem is to define the undefined symbol in your 
application. For example, if your C program links with the Fortran library, it will 
now have an undefined symbol of MAIN_. In your C program you could define a 
subroutine: 
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MAIN_() 


This would satisfy the undefined external reference. The same could be done for 
Pascal by defining a routine: 


program () 
{ 
} 


If you do not want to use the Sun FORTRAN or Sun Pascal workaround, updated 
versions of the Fortran and Pascal libraries are supplied with your SunOS 4.1.2 
distribution and should be applied after your upgrade (or any new installation or 
re-installation of 4.1.2 occurs). See Section 7.15 in Chapter 7 for more informa- 
tion. 


Undefined external references may also occur with user and third-party supplied 
shared libraries. In some of these cases, the undefined symbols may have no 
practical value — as the program may never actually use the code paths that 
reference the undefined symbol (this is the case with the Sun-supplied libraries.) 
In this event, the diagnostic from the loader may be ignored and the program exe- 
cuted anyway (unless there is some other diagnostic that prevents completion of 
link editing.) Note, however, that if a code path accessing any undefined symbol 
is actually used, the dynamic link editor will abort the program at the time the 
symbol is referenced (or immediately upon start-up if the reference is from a data 
structure.) 


In the case of bug 1052428 (“ld.so usage of -L options confusing, leads to secu- 
rity probs’’), the dynamic loader’s usage of stored search paths specified by "-L" 
options to 1d has been restricted to the use of absolute path names (names begin- 
ning with "/") when running a set -user- or set -group-ID program. 


Summary of bugs fixed in /usr/bin/1d: 

1019004 assert definitions can fail to report undefined symbols 

1032739 ld core dumps with many libs in multiple directories 

1034788 -r and -pic do not mix bad secondary magic number error 

1034833 ld: can’t mixed -r with -Bstatic or -A flag 

1037879 Cannot create executable with shared object which points 
to another shared object. 

1041946 (duplicated by 1065275, below). 

1042261 ld only recognized first directory in LD_LLIBRARY_PATH 

1044524 multiply defined symbols and seg. fault caused by 4.1’s ld 

1045272 ld -u & -r do not seem to work properly 

1046462 ld fails with segmentation fault when processing nested 
#include files 

1050594 fix uninitialized structure entries. 

1064820 Id can produce bogus diagnostics when processing cascaded 
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dependencies 
1065275 program dumps core with shared objects having only statics. 


Summary of bugs fixed in /usr/1ib/ld.so: 
1033086 Calling dlopen() on a file with BSS kills your application. 
1043300 diclose prevents access to functions even after further dlopen 
1045194 dlsym returns bad address for uninitialized global variable 
1046379 cannot call a function in a [.so] from a function in another 
1052428 1d.so usage of -L options confusing, leads to security probs 


2.3. SPARCsystem 600MP This section has two subsections: the first subsection lists and describes new 


Systems SPARCsystem 600MP hardware support and software features; the second sub- 
section briefly describes the SPARCsystem 600MP multiprocessing environ- 
ment. 

Description of New Features e Newcommands (mpstat (1) and mps(1)). 


The command mpstat shows average and per-processor percentage usage 
data during a time interval. The command mps displays the status of current 
processes on an MP system. See the man pages for these commands for 
details. 


e Extended SCSI device support for SPARCsystem 600MP series 


The SunOS 4.1.2 GENERIC sun4m kernel configuration file declares support 
for five SCSI buses. 


e Open boot PROM support for SPARCsystem 600MP series machines 
See Chapter 5 for a discussion of the open boot PROM and its use. 
e New version of Sundiag 


The latest version of Sundiag, version 2.3, is included in SunOS 4.1.2. Sun- 
diag 2.3 features a new multiprocessor test, mpt est, for validating 
SPARCsystem 600MP multiprocessing hardware. See Appendix C for a 
description of the new features and enhancements of Sundiag 2.3. 


Note that Sundiag 2.3 is SunView-based; it will not run in OpenWindows. 
If Openwindows is running, you must quit the window system. You can then 
run Sundiag from the monitor prompt (no window system) or you can run 
Sundiag from the SunView window system. 


e New kernel configuration files for SPARCsystem 600MP series systems: 


The following kernel configuration files are available for various system 
configurations: 


—DL: diskless Sun-4m system 

— NFS: Sun-4m with scsI disks and tape; boot from server 
~SDST: Standalone Sun-4m with SCsI disks and tape 
—IDST: Sun-4m with IPI disks and SCSI tape 
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The SPARCsystem 600MP 
Multiprocessing Environment 


How MP Works 


The Operating System 


Application Programs 


2.4. Writing Device Drivers 


for SPARCsystem 
600MP Systems 


SunOS 4.1.2 has been modified and tuned to function on multiprocessor (MP) 
hardware. The changes made to the kernel take advantage of the multiprocessing 
capability, yet provide complete binary compatibility with SunOS 4.1, 4.1.1, and 
SunOS 4.1.1 Rev B. The interfaces provided to the user in the form of libraries, 
system calls, and commands have not changed from SunOS 4.1.1 Rev B; two 
commands — mpstat (1) and mps(1) — have been added. Systems will 
automatically have increased throughput from the MP hardware, under appropri- 
ate applications. 


The 600MP series uses a tightly-coupled, shared-memory configuration model. 
Several CPUs share real memory, but all processes have their own virtual address 
space and the kernel memory management system controls virtual-to-real address 
translation. Only one copy of the operating system exists, and is shared by all 
the processors. Interrupts can be serviced by any processor, and processors can 
send each other interrupt signals. 


Processors accessing kernel data structures and code do so after acquiring locks 
that prevent other processors from accessing the same data structures or execut- 
ing the same code concurrently. Various optimizations have been made to 
minimize the overhead due to synchronization. 


Application programs running in user mode have their own virtual address space 
and do not have to worry about shared memory synchronization. Several such 
applications can run concurrently on separate processors. In these cases addi- 
tional processors will provide almost linear increases in the system’s overall 
throughput. 


Applications that enter the kernel to utilize system resources will have to go 
through the additional overhead of synchronization; therefore, a mix of applica- 
tions that spends a large proportion of its time executing in the kernel will have 
lower throughput than a mix of applications that spends a small proportion of its 
time in the kernel. 


See Appendix B for information about writing device drivers for SPARCsystem 
600MP systems. 
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About OpenWindows 


OpenWindows Version 2 is the default window system for SunOS 4.1.2, and is 
included on the SunOS 4.1.2 release CD; pre-installed systems with adequate 
disk space will be installed with OpenWindows Version 2. 


OpenWindows Version 3 is co-packaged with SunOS 4.1.2; it is on a separate 
CD in the media box, along with the XGL 2.0 RTE software. 


This chapter includes information about OpenWindows Version 2 and OpenWin- 
dows Version 3. See Chapter 10 in the Open Issues packet in the Release Mini- 
box for known problems with Versions 2 and 3. 


3.1. Why Use Consider switching to OpenWindows Version 3 if the following new features and 
OpenWindows Version _functions are important to you: 
3? 


e 24-bit graphics support for sophisticated color applications 

e Fast, direct access to hardware for graphics-intensive applications 

e 8-bit internationalization capability 

e Enhanced DeskSet 3.0 

e ToolTalk, a new state of the art tool for inter-application communication 


e Improved application integration through new network-transparrent drag- 
and-drop mechanism 


e 3D look and feel 

e Mouseless support 

e Audio capability in deskset environment 
e Easy migration to SVR4 


See the following documents to learn how to install and use OpenWindows Ver- 
sion 3: 


e OpenWindows Version 3 Installation and Start-Up Guide (PN 800-6029-10 
e CDmanager and CDM 2.0 User’s Guide (PN 800-6174-10) 
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3.2. General 
OpenWindows 
Features 


X Window System 


News 


XView Toolkit 


NeWS Toolkit 


OPEN LOOK Interface 


OPEN LOOK Intrinsics 
Toolkit 


OpenWindows DeskSet 
Environment 


OpenWindows includes the following features: 

e X11/NeWS, a merger of two independent window system protocols 
e XView Toolkit 

e NeWS Toolkit (TNT) 

e The OPEN LOOK user interface 

e OPEN LOOK Intrinsics Toolkit (OLIT) 


e OpenWindows DeskSet Environment 


X11 is version 11 of the X Window System developed at MIT. The X Window 
System is the industry standard for a network-based, operating-system indepen- 
dent window system. 


NeWS is the “Network extensible Window System” developed by Sun and origi- 
nally offered as a separate window system. 


The XView Toolkit is a development toolkit that goes with the X11 side of 
X11/NeWS. It is used to produce X11 applications based on the OPEN LOOK 
graphical user interface. 


The NeWS Toolkit is a new toolkit for NeWS programmers. 


The OPEN LOOK interface is a set of specifications that define consistent visual 
and operational features; it gives a uniform look and feel to all OpenWindows 
applications. 


The OPEN LOOK Intrinsics Toolkit is a user interface toolkit based on MIT’s Xt 
Intrinsics. 


The OpenWindows DeskSet Environment provides mouse-oriented and 
icon—oriented tools in the OPEN LOOK for standard functions and services such 
as: 


e File management (opening, closing, copying, moving files, etc.) 
e E-mail 

e System and CPU performance monitoring 

e Calendar display and scheduling 


e Printing files and mail messages 
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3.3. About OpenWindows 
Version 2 


Do Not Install Sun IPX 
Supplement 


Keyboard Map File for 
Japanese International 
Keyboard 


Using SunView for Maximum 
Security Levels 


3.4. Which Default 
Window System? 


New User; OpenWindows 
Comes Up as Default 
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Note the following about OpenWindows Version 2. See Chapter 10 for a listing 
and descriptions of known problems with OpenWindows Version 2. 


SunOS 4.1.2 OpenWindows Version 2 includes the Sun IPX supplement; do not 
install this patch after installing SunOS 4.1.2. 


The keyboard map file for the Japanese international keyboard is 5 apan4 “DS: 
See Chapter 3 of the OpenWindows Jnstallation and Start-Up Guide for more 
information. 


If you require maximum levels of security, use the SunView window system. 
SunView, which is a kernel—based window system, presents a more secure 
environment than a networked window system such as OpenWindows. (Refer to 
the OpenWindows Version 2 Release Notes, page 13, for a detailed description of 
OpenWindows security.) 


The features and use of OpenWindows are fully described in the manuals in the 
OpenWindows End User’s Kits provided with the SunOS 4.1.2 Release Minibox 
(SX-9E). If you plan to use OpenWindows, you should make sure that you have 
this documentation. 


Depending on how your system is set up, one of the following scenarios will be 
played out when you log in: 


e New user logging in for the first time; OpenWindows comes up as the 
default window system 


e New user logging in for the first time; SunView comes up as the default win- 
dow system 


e New user logging in for the first time; system offers choice of SunView or 
OpenWindows as default system 


e New user logging in for the first time; no default window system. User 
receives a shell prompt after logging in 


e Old user logging in for the first time under this new operating system; old 
home directory was backed up and restarted. User gets same window system 
he/she previously had 


Each situation is covered separately in the following sections. 


If you are a new user on a SunOS 4.1.2 system and the "“openwin" executable can 
be found, OpenWindows Version 2 will be your default window system. Note 
that this setting occurs in the .cshrc (or .profile) file in your home direc- 
tory. Note also that the desktop program, described below, can easily change 
your default window system. 


When you log in, you will see the message: 
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starting OpenWindows (Control-C to interrupt) 


If you do not interrupt with (Control-C ), OpenWindows will come up after a short 
delay. 


You should now check to make sure that the OpenWindows Calendar Manager 
has been initialized: 


e Display the Workspace Programs menu by moving the mouse cursor to a 
screen background area and pressing the right mouse button 

e Drag the cursor to the right edge of the Programs option to display the Pro- 
grams submenu 

e Select the Calendar Manager 


If the Calendar Manager has not been initialized, at the bottom of your screen, 
below the calendar, you will see the error message: 


rpc.cmsd is not responding...have you run install _cmgr? 


If you do not see the message, do not run install_cmgr. If it has been run 
previously, running it again causes problems. If the message is displayed, you 
need to take the following steps: 


e Become superuser and run install_cmgr: 


$su 
Password: 


| /usz/openwia/ /bin/xview/install_ _emgr 


e Exit OpenWindows 


e Log back in to your system and let OpenWindows come up again 


New User; SunView Comes If you are a new user on a SunOS 4.1.2 system and the openwin executable 

Up as Default cannot be found, SunView will be your default window system. Note that this 
setting occurs in the .cshrc (or .profile) file in your home directory. Note 
also that the desktop program, described below, can easily change your default 
window system. 


New User; No Default If you are a new user but your account was not set up with the add_user pro- 

Window System gram or by copying the default .cshrc (or .profile) and .1login files into 
your home directory, you will not have a default window system; you will have a 
shell prompt when you log in. 
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Old User; Previous Window 
System 


3.5. Changing the Window 
System to be Invoked 
upon Login 


3.6. Online Desktop 
Tutorial 


3.7. OpenWindows Online 
Tutorial 


G 


If you are an old user logging in for the first time under this new operating sys- 
tem, and you have re-installed the home directory you had been using before ins- 
tallation of the new operating system, you will have the same window system 
you previously had. 


With SunOS 4.1.2 you can change the window system invoked upon login by 
using the desktop (1) command. Note that this applies if you are using the 
default .cshrc file (from /usr/1ib/Cshrc) and if you have modified the 
section of code regarding window-system invocation. 


will change it to SunView. 


An online tutorial, Introducing Your Sun Desktop, is provided in this release. 
The introduction is part of the default desktop and introduces you to some basic 
OpenWindows principles. It includes two short cookbook walkthroughs explain- 
ing how to copy, cut, and paste text, and how to use File Manager. Besides pro- 
viding you with some basic skill training, the introduction allows you to start 
some of the deskset utilities, test your SPARCstation’s audio capabilities, and 
select between German, French, and English versions of the introduction. 


You can access the online tutorial at any time when running OpenWindows by 
selecting it from the Workspace Programs menu. If you’d like to get spot help in 
French and German for the File Manager and Mail Tool, see page 36 of Introduc- 
ing Your Sun Desktop. 


This online tutorial provides instruction on all the basic skills necessary for 
becoming a capable end-user of Sun Microsystems’ OpenWindows software. In 
addition to the easy-to-follow explanations, the tutorial offers demonstrations or 
simple animated examples of how the software works. 


The demonstrations are designed to display the software in detail and first-time 
users may find them especially helpful. Because the demonstrations’ animated 
scripts create a separate environment, you have to turn off system security in 
order to run them. 


You can, however, run the tutorial without accessing the demonstrations. This 
allows you to call up the tutorial for reference at anytime you are running 
OpenWindows and need a quick reminder. 


There are two ways to view the online tutorial: 


e With animated demonstrations 
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Accessing the Online Tutorial 
with Animated Demonstrations 


Returning to OpenWindows 


e Without the animated demonstrations 


The animated demonstrations run on Sun’s standard monochrome and color 
monitors (1152 X 900 pixels). They do not run correctly on the high resolution 
monitor (1600 X 1280 pixels). If you attempt to view an animated demonstration 
while running OpenWindows on a high-resolution monochrome monitor, an 
alert to this effect appears on the screen. 


You should also be aware that the demonstrations included with your online 
tutorial were designed to work using OpenWindows’ default settings. It is possi- 
ble to change these settings (as the online tutorial itself explains), but if you do, 
the animated demonstrations may not perform correctly. 


Do not move the mouse or press any mouse buttons or keyboard keys while 
a demonstration plays. This will interrupt the demonstration and can cause 
your system to crash. 


To access the online tutorial with animated demonstrations: 
1. Exit OpenWindows. 


To exit OpenWindows, press and hold the right mouse button anywhere in 
the background of your screen (wherever there is no window or icon). A 
Workspace menu appears. Still holding the right mouse button down, drag 
down, highlight Exit, and release the mouse button. 


2. Atthe % prompt on a full screen without windows, enter: 


The online tutorial appears on your screen with a Console window displayed 
nearby. Do not quit the Console window; it is there to accept system messages 
for you. 


Proceed to the tutorial section titled “Introduction—Read This First” for instruc- 
tions on using the online tutorial. To do this, click the left mouse button twice in 
rapid succession on the screen button marked “GoTo” beside the words 
‘“Introduction—Read This First.” 


To return to OpenWindows when you finish the online tutorial: 


1. Exit OpenWindows (as described in the previous section). 


2. Atthe prompt enter: 
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Accessing the Online Tutorial 
without Animated 
Demonstrations 


Moving Around in the Tutorial 


Closing the Tutorial 


To access the online tutorial without animated demonstrations, from within 
OpenWindows enter: 


This is to remind you that security is on and animated demonstrations are not 
available. As long as you continue in the current mode (without demonstrations), 
a similar alert appears whenever you attempt to call up an animated demonstra- 
tion. 


We recommend that you operate the online tutorial without animated demonstra- 
tions whenever you want a quick refresher on OpenWindows features, tools, util- 
ities, or functions. 


When the tutorial comes up on your screen, the first thing you see is the Table of 
Contents. Next to each topic is a “GoTo” button. To learn about any topic or 
feature listed in the Table of Contents, position your mouse cursor over the GoTo 
button next to the topic you want and double-click using SELECT (the left 
mouse button). This takes you to the first page of the selected section of the 
tutorial. 


When you are done with the tutorial, or if you want to take a break, you can close 
the online tutorial window to an icon on your screen. 


To close the online tutorial window, put your cursor in the border of the window. 
Press and hold MENU (right mouse button) and a pop—up window appears. Pull 
your cursor down to highlight the Close option and release the mouse button. 
The online tutorial is then suspended and a small icon appears on your monitor 
screen. 


There are two ways to reopen the online tutorial from its icon. You can 
double-click SELECT (left mouse button) on the icon and the online tutorial 
re—opens for use. You can also press and hold the right mouse button (MENU) 
over the icon; when the menu appears, highlight the Open option and release the 
mouse button. 
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Quitting the Online Tutorial Instead of closing the online tutorial, you can quit and exit the application 
entirely. To quit the online tutorial, position your cursor either in the tutorial 
window border or over the tutorial icon. Call up the window menu by pressing 
and holding MENU (right mouse button) and then highlight the Quit option. The 
tutorial window (or the icon) then disappears from the screen. 
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4.1. Peripheral Support 


New Hardware Features 


SunOS 4.1.2 includes kernel or device support for the following new hardware 
products and features: 


1.3GB SCSI disk drive 

GT graphics accelerator (Sun-4c) 

GS graphics accelerator (Sun-4c) 
GXplus graphics accelerator (Sun-4c) 
TC-compatible frame buffer (Sun-4c) 
VX graphics accelerator (Sun-4) 
Support for SPARCsystem 600MP series systems, including: 
— Up to five SCSI buses 

~ Open boot PROM support 

— Sbus and Mbus expansion buses 

— Improved network connections 

— Various enclosure configurations 

— CPU board bus and port options 

— CPU board memory options 

— Monitor options 

— Printer interface options 

— single-slot GX graphics accelerator 


— MGI frame buffer 


SunOS 4.1.2 adds support for the new 1.3GB, 5 1/4-inch SCsI disk drive, a high- 
performance drive that incorporates Zone Bit Recording (ZBR), a method of 
recording that divides the surface of the disk into different zones, each with a dif- 
ferent number of bytes per track. This keeps the bit density constant across the 
surface of the disk, thus achieving higher performance and capacity. 
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4.2. Graphics Support 


GXplus Graphics Accelerator 


GS Graphics Accelerator 
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Note that the patch release titled 7.3 GB Disk Drive Enhancement, for supporting 
this drive under SunOS 4.1 and SunOS 4.1.1, is not required; the part numbers 
for this patch were: 


704-2948-11 (CD-ROM) 
700-2948-11 (tape) 


SunOS 4.1.2 also incorporates all functionality and fixes from the 4.1.1-GFX 
Rev.1 and 4.1.1-GFX Rev.2 releases. This includes Sun-4c support for the GS, 
GT, and GXplus graphics accelerator boards and the TC-compatible frame 
buffer, Sun-4 support for the VX graphics accelerator board, and Sun-4m support 
for the single-slot GX graphics accelerator. All of these graphics devices except 
for the VX graphics accelerator were previously supported via GFX or other 
feature releases; the VX graphics accelerator was an unbundled device. 


The GXplus is a memory enhanced version of the familiar double-wide Sbus GX 
card (also known as acg6). It has four Mbytes of video RAM compared to one 
Mbyte on the standard GX. This enables the GXplus to support double buffering 
for smoother dynamic graphics, and fast retained windows for speedy damage 
repair. It also supports 1280 x 1024 resolution. GXplus is 100% backward- 
compatible with GX application software. 


The GS is an integrated frame buffer and graphics accelerator that features 24-bit 
true color, accelerates the rendering of 3D solids, and also accelerates window 
system performance; it is also known as acg12. Additional features include: 


e 24-bit double buffering (transparently dithered by hardware to 12-bit) 
e 16-bit Z-buffer 

e Gouraud shading using up to 8 colored light sources simultaneously 
e Hardware picking and BitBlt 

e Support for 76 Hz. monitor 

e Separate cursor planes (in OpenWindows Version 3) 


e Multiple rendering modes, allowing 1-bit, 8-bit, and 24-bit applications to be 
run and displayed simultaneously 


e Support for SunView software application programmer interfaces (APIs), 
including Pixwin (but not Pixrects), and SunPHIGS 1.2, 1.3, 1.4, and later 


e Support for OpenWindows Version 3 software application programmer 
interfaces (APIs) and toolkits, including SunPHIGS 2.0, XGL 2.0, GKS 4.1, 
XView, OLIT, TNT, and Xlib — 


The SunView window system is fully supported by the GS. OpenWindows Ver- 
sion 2 runs on the GS in monochrome overlay only. OpenWindows Version 3 on 
the GS supports visuals in 4-bit, 8-bit, and 24-bit plane groups. 
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GT Graphics Accelerator 


VX Graphics Accelerator 


TC-Compatible Frame Buffer 


4.3. Support for 
SPARCsystem 600MP 
Series 
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The SPARCstation GT is a high-performance 24-bit true color graphics accelera- 
tor that provides high-quality advanced 2D and 3D accelerated graphics features. 
Features include: 


e 8-bit and 24-bit double buffering 

e 24-bit Z-buffer 

e 8-bit double-buffered overlays 

e 10 window ID planes 

e four double-buffered, fast clear planes 

e Separate cursor planes (in OpenWindows Version 3) 
e Line, polygon, and stroke text anti-aliasing 


e Support for OpenWindows Version 3 software application programmer 
interfaces (APIs) and toolkits, including SunPHIGS 2.0, XGL 2.0, GKS 4.1, 
XView, OLIT, TNT, and Xlib 


The SunView window system is fully supported by the GT. OpenWindows 
Version 2 runs on the GT in monochrome overlay only. OpenWindows Ver- 
sion 3 on the GT supports visuals in 8-bit and 24-bit plane groups. 


The VX is one of Sun’s second generation visualization acceleratorsf or Sun 
SPARCsystems. The VX, a successor to the TAAC-1, includes a high perfor- 
mance, floating point processor, a 16 MByte frame buffer, and a GX-accelerated 
system frame buffer. 


The TC is a basic "dumb" 24-bit true color frame buffer with an additional 2-bit 
overlay/enable plane group; it is also known as a cg8. 


Under SunView, the TC supports 1-bit, 8-bit, and 24-bit plane groups. The user 
is cautioned that the 8-bit support is achieved by software simulation of an 8-bit 
mode within the 24-bit plane group; 8-bit performance is less than that found 
with a typical 8-bit frame buffer. 


Under OpenWindows Version 3, the TC supports 1-bit and 24-bit visuals, with 
no 8-bit support. The 1-bit plane group is the default visual; if you wish, you can 
specify the 24-bit TrueColor to be the default visual at the time you start 
OpenWindows. See the OpenWindows Programmer’s Guide for more informa- 
tion. 


SunOS 4.1.2 supports SPARCsystem 600MP series systems. SPARCsystem 
600MP series systems, which are available in two and four processor 
configurations, offer multiprocessing to improve compute performance, plus net- 
work and I/O enhancements that improve server performance. Multiprocessing 
provides scalable CPU performance that can cover a wide range of customer 
needs and significantly extend the top system performance beyond existing Sun 
systems. All 600MP series systems use a tightly-coupled, shared memory mul- 
tiprocessing mode and high-bandwidth MBus for the primary connection 
between the CPUs and memory. The processors are located on module cards that 
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Support for Multiple SCSI 
Buses on SPARCsystem 
600MP 


Open Boot PROM 


Sbus and Mbus Expansion 
Buses 


Improved Network 
Connections 


Enclosure Configurations 


CPU Board Bus and Port 
Options 
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plug into MBus connectors on the CPU board, offering easy upgrading to addi- 
tional processors or future SPARC technology. 


The SunOS 4.1.2 GENERIC sun4m kernel configuration file declares support for 
five SCSI buses and the devices that can be connected to them. The 
GENERIC_SMALL kernel configuration file declares two SCSI buses and the dev- 
ices that go with them. 


The open boot PROM supports booting of a SPARCsystem 600MP series system. 
In most standard configurations, when you install SBE/S cards on the CPU board 
the devices are recognized automatically. If you have a non-standard 
configuration, you need to reconfigure the kernel. See Chapter 5, “Open Boot 
PROM 2.0 and Hierarchical Device Naming” for detailed information about the 
open boot PROM and how to boot a SPARCsystem. 


Two different expansion buses provide the benefit of Sun’s latest technical inno- 
vations while linking the system to established Sun products. The 600MP series 
systems are the first large server systems to use the SBus, which is the primary 
I/O bus for system services and expansion. SBus offers much higher I/O perfor- 
mance and uses low-cost CMOS technology for a variety of add-on options such 
as disk controllers and network interfaces. But, because 600MP series systems 
were designed to support VME boards, you can continue to use most of your 
VME bus options in Sun’s servers. 


For networking, 600MP series systems offer an on-board buffered Ethernet con- 
nection (the SBus SCSI/Buffered Ethernet Card — also called the SBE/S card) 
that can handle bursts of packets from high-speed client workstations better than 
a non-buffered connection, improving responsiveness and reducing network and 
server loading. Also supported is the new SBus FDDI and token ring options, 
which offer you tremendous flexibility in your choice of LAN technology. 


Note that up to five Ethernets can now be supported on a SPARCsystem 600MP 
series system — one on the CPU board and one each on the four SBE/S cards. 


The 600MP series systems are packaged in one of three enclosures: the 5-Slot 
Office Pedestal (630MP), the 12-Slot Office Pedestal (670MP), or the 56-inch 
Data Center Cabinet (690MP). See the appropriate hardware manuals for details. 


The Sun 600MP CPU board operates at 40 MHz. The CPU board can have one 
MBus module (two processors) and four Sbus expansion slots or two Mbus 
modules (four processors) and three Sbus expansion slots. 


The Sun 600MP CPU board also has the following ports: 
e two RS232/RS423 synchronous serial ports 

e Ethernet port 

e SCSI port 
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CPU Board Memory Options 


Monitor Options 


Graphics Support 


Printer Interface Options 


4.4. Related SPARCsystem 
600MP Documents 
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e keyboard/mouse port 
e scan port for remote diagnostic service processor 


e audio port (SPARCstation 1-style audio) 


The memory on the Sun 600MP CPU board can be expanded in 16 or 64 MB 
SIMM increments to a maximum of 128 MB. The CPU board has 32 SIMM slots 
in two banks of 16. The following SIMM sets are available for insertion in these 
slots: 


e 16MB ECC Memory Expansion SIMMs (1 MB SIMMs) 
e 64 MB ECC Memory Expansion SIMMs (4 MB SIMMs) 


The 600MP series systems are normally configured as networked servers. Custo- 
mers can add a display monitor to use as console or to create a workstation 
configuration. 


The only supported graphics device for the SPARCsystem 600MP series are the 
single-slot GX graphics accelerator and the MG1 frame buffer. 


The 600MP series systems offer both serial and parallel interfaces. The serial 
interface is on the CPU board. The SBus parallel interface for the SPARCprinter 
is the parallel laser printer card. 


The following documents contain additional information about the 
SPARCsystem 600MP series systems. 


Document Part Number 
SPARCsystem 630MP Installation Manual 800-5937 
SPARCsystem 670MP Installation Manual 800-5904 
SPARCsystem 690MP Installation Manual 800-5935 


600MP CPU and Memory Board Installation & Service Manual 800-5318 
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5.1. Built-in Aliases for 
Standard Devices 


Open Boot PROM 2.0 and Hierarchical 
Device Naming 


This chapter provides information about open boot PROM 2.0 and hierarchical 
device naming on all machines with open boot PROM 2.0 (SPARCstation 2, 
SPARCstation IPX, SPARCstation ELC, all SPARCsystem 600MP systems, and 
some SPARCstation IPCs). 


Most users, once release software has been installed from tape or CD-ROM, only 
need to boot from their default boot source and never have to be concerned with 
either boot device aliases or hierarchical device names. For such users, the only 
times it is necessary to boot are when their machine has been turned off, in which 
case turning it on again causes it to reboot automatically, or when their system 
has crashed or frozen. In this case, turning the machine off and then on again 
automatically reboots from the default source. 


The user of a desktop SPARCsystem who accidentally arrives at the PROM Moni- 
tor prompt by pressing (Li/Stop)- (a) or otherwise interrupting the system, can 
simply follow the screen prompt that is displayed in this situation and enter either 
go, at the ok prompt, or c, at the > prompt, in order to continue. 


The only case in which it is necessary to enter a device name is when booting is 
to be from a non-default device. For many users who reach this point, the non- 
default device is a standard device for which there is a predefined alias (described 
below). 


Prior to SunOS 4.1.1 and the SPARCstation 2, a disk controller purchased from 
manufacturers other than Sun could not be used for booting unless the manufac- 
turer specifically designed the controller to work under a Sun boot PROM, or 
received code from Sun that could be incorporated in the controller. The open 
boot PROM and new conventions for hierarchical device naming now make it pos- 
sible for a Sun Desktop SPARCsystem or a SPARCsystem 600MP system to 
boot from disk controllers that have not been specifically coordinated with Sun 
specifications. 


All open boot PROM 2.0 systems have a set of predefined aliases for standard dev- 
ice names. These are adequate in the great majority of situations. The only time 
it should be necessary to go beyond these aliases is when you are using a newly 
configured type of device to boot from or when you are booting from a 
non-standard source. 
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Switching from Restricted There are two operational monitors available with open boot PROM 2.0 systems: 

Monitor to Forth Monitor the restricted monitor, which uses the > prompt, and the Forth monitor, which 
uses the ok prompt. You can do simple booting procedures from either prompt, 
but you need to be in the Forth monitor to perform more complex functions. 


See the Open Boot 2.0 Command Reference manual (Part Number 800-6076-10) 
for detailed instructions for using the open boot PROM. 


To switch from the > prompt to the Forth prompt, type n (for new-mode): 
> n 
ok 

To switch from the ok prompt to the restricted prompt, type ol d-mode: 


ok old-mode 


| 


Booting Open Boot PROM 2.0 The table below shows a sample of the bootpaths that are required for booting a 

Systems from the CPU (except — system with Open Boot PROM 2.0 and higher. To boot with one of the 

690MP) predefined aliases, type boot and the appropriate alias from the ok prompt or 
type b and the appropriate alias from the > prompt. Note that the SPARCsystem 
690MP, which has IPI disks, has a different set of aliases for booting from disk. 


Table 5-1. Booting an Open Boot PROM 2.0 System from the CPU 


PROM Monitor Aliases for Device Path Names 


Open Boot 
Alias Full Device Path Boot From: 


/iommu/sbus/dma @f,8 1000/esp @f,80000/sd @ 3,0 Default disk (1st onboard) 
/iommu/sbus/dma @f,8 1000/esp @f,80000/sd @ 3,0 First onboard disk 
/iommu/sbus/dma @ f,8 1000/esp @ f,80000/sd @ 1,0 Second onboard disk 


/iommu/sbus/dma @f,8 1000/esp @ f,80000/sd @ 2,0 First external disk 
/iommu/sbus/dma @f,8 1000/esp @ f,80000/sd @0,0 Second external disk 
/iommu/sbus/dma @f,8 1000/esp @ f,80000/st @4,0 Default tape drive (first) 
/Aiommu/sbus/dma @ f,81000/esp @f,80000/st @ 4,0 First tape drive 
/Aiommu/sbus/dma @f,8 1000/esp @ f,80000/st @ 5,0 Second tape drive 
/iommu/sbus/dma @f,8 1000/esp @f,80000/sr @ 6,0:a CD-ROM partition a 
/Aiommu/sbus/dma @f,8 1000/esp @ f,80000/sr @ 6,0:d CD-ROM partition d((MUNIX) 
/iommu/sbus/lebuffer @ f,40000/le @ f,60000 Default Ethernet 
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Booting a SPARCsystem 690MP from the CPU 


The table below shows a sample of the bootpaths that are required for booting a SPARCsystem 690MP with Open 
Boot PROM 2.0 and higher. 


Table 5-2. Booting a SPARCsystem 690MP from the CPU with Open Boot PROM 2.0 
PROM Monitor Aliases for Device Path Names 
Open Boot 
Alias Full Device Path Boot From: 


ipi /Aiommu/vme/idc @ 4d, 1080000/id @0,0 Default disk (first) 
ipi0 /fiommu/vme/idc @ 4d, 1080000/id @0,0 First disk drive 
ipil Aiommu/vme/idc @ 4d, 1080000/id @ 1,0 Second disk drive 


ipi2 /Aiommu/vme/idc @ 4d, 1080000/id @ 2,0 Third disk drive 

ipi3 /Aiommu/vme/idc @ 4d, 1O80000/id @ 3,0 Fourth disk drive 

ipi4 /iommu/vme/idc @ 4d, 1080000/id @ 4,0 Fifth disk drive 

ipi5 /Aiommu/vme/idc @ 4d, 1080000/id @ 5,0 Sixth disk drive 

ipi6 /iommu/vme/idc @ 4d, 1080000/id @ 6,0 Seventh disk drive 

ipi7 fiommu/vme/idc @ 4d, 1080000/id @7,0 Eighth disk drive 

tape /iommu/sbus/dma @f,8 1000/esp @f,80000/st @4,0 Default tape drive (first0 
tapeO /iommu/sbus/dma @f,8 1000/esp @f,80000/st @4,0 First tape drive 

tapel /iommu/sbus/dma @f,8 1000/esp @f,80000/st @ 5,0 Second tape drive 
cdroma /Aiommu/sbus/dma @f,8 1000/esp @ f,80000/sr @6,0:a CD-ROM partition a 
cdrom /iommu/sbus/dma @ f,81000/esp @f,80000/sr @ 6,0:d CD-ROM partition d((MUNIX) 


net /iommu/sbus/lebuffer @ f,40000/le @ f,60000 Default Ethernet 


Changing Default Boot Device To change the default boot device, you need to execute the set-defaults 
command to make sure every NVRAM parameter is in its default state, and set the 
default boot device on the open boot PROM. 


1. Atthe ok prompt, execute set-defaults: 


ok set-defaults 
Setting NvrRaM parameters to default values. 


ok 


This command can be used to restore the NVRAM to a known state. Nor- 
mally, executing this command once before or during the OS installation 
will be enough, but it could be used any time to get back to the ‘factory’ 

defaults of the NVRAM parameters. 


2. Set the default boot device; for instance, to designate the first IPI disk as the 
boot device, do the following: 


ok setenv boot-device ipid 


ok 
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5.2. Hierarchical Device 
Naming 


5.3. Device Naming 
Conventions 


This will ensure that the system will boot up without any user interaction 
after a power-on, for instance. If the OS is installed on the first disk (ID 0) 
of the first IPI controller, the boot device name is ipi or ipi0, as shown in 
the above example. 


Optionally, the NVRAM parameter diag-device, which is used if the sys- 
tem is in DIAG mode, could be set to be the same as boot -device with 
the following command: 


ok setenev diag-device ipi0 


With this setting, auto boot will work even if someone hits the DIAG switch 
by mistake. 


Devices are attached to a system on buses, with a device at one end of a bus con- 
trolling devices at the other end. This establishes a hierarchy of devices that can 
be represented as a tree of nodes, with each device a node and the system itself 
the top node. In hierarchical device naming, the name of a device is given as the 
path from the top of the device tree to the device itself. 


Hierarchical device naming makes it possible to specify new device parameters 
not previously contained in a CPU’s NVRAM for accessing disk devices. For 
example, to specify the system bus, bus adapter, and controller to be used by a 
new disk, one might want to specify a hierarchy such as: 


/sbus/vme/ [new controller type\/[new disk type] 


Rules for specifying hierarchical device names are given in “Device Naming 
Conventions,” below. All open boot device names must initially be entered as 
complete pathname hierarchies. 


Hierarchical device names can be long and complicated; entering a full hierarchi- 
cal device every time one wanted to execute a command to boot would be a tedi- 
ous and error prone process. To simplify commands, the open boot PROM pro- 
vides a set of predefined one-word aliases for standard devices and allows you to 
define an alias of your own for any hierarchical device name. For the great 
majority of users, no specific knowledge of hierarchical device naming will ever 
be necessary in order to operate their system. 


A hierarchical device name is specified by giving a path from the top node of the 
device tree to the device itself. Each node on the device path is marked by a 
slash (“/’). An example of a device-name path is: 


/sbus@1,f£8000000/esp@0, 800000/sd@3,0:b 


The first “/”’ represents the highest node, the workstation itself. Connected to it is 
an SBus at the address f8000000. The next node is the SBus itself. At the first 
slot on the SBus (““@O0” ), with an address offset of 800000, is an esp SCSI host 
adapter. A SCSI disk (sd) is connected to the esp SCSI host adapter as logical 
unit 1 (0) at target 3 (this corresponds to UNIX device name sd0). Finally, the 
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66,9? 


element after the “‘:” is a device-specific parameter. In this case, it identifies par- 
tition b of disk sd0, which might be used in booting the miniroot during instal- 
lation. 


The devices in a device tree are identified by node names consisting of: 
driver-name @ unit-addresses:device-parameters 


sbus@1,£8000000 is a node name in the device-name path above. 1 and 
£8000000 are unit addresses for the SBus. No SBus device parameters are 
specified. 


29 


A driver-name can be made up of letters, digits, and the special characters “_, 
“+,” “_” which are treated as letters. Upper and lower case are distinct; length 
can be from | to 31 characters. sbus and esp are driver names. 


@unit-addresses is optional. If specified, there can be one or more unit 
addresses. A unit-address can be made up of letters and digits. It can be arbi- 
trarily long, although sequences of more than eight characters are discouraged. 


:device parameters is optional. If specified, there can be one or more device 
parameters. A device parameter can be made up of letters and digits. It can be 
arbitrarily long, although sequences of more than eight characters are 


discouraged. 
5.4. Using show-devs From the PROM Monitor prompt, you can use the show-devs command to 
Command to Display display the devices known to a system: 


Device Names 


ok show-devs driver-name 


— driver-name is optional; when used, show-devs only displays device 
paths descending from the node identified by the entry. 


ok show-devs 
/options 
/£d@1,£7200000 
/ttyb 

/ttya 
/keyboard 


/sbus@1, £8000000/esp@0, 800000/sd 
/sbus@1,£8000000/esp@0,800000/st 
/packages/deblocker 
/packages/sun-label 


Note: Sample display; contents may vary, depending on user input and the system used. 
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5.5. Using devalias 
Command to Show and 
Define Device Aliases 


5.6. Open Boot PROM 
Environment 
Parameters Stored in 
NVRAM 


printenv Command 


ok show-devs /sbus 
/sbus@1,f8000000/1le@0,c00000 
/sbus@1,£8000000/dma@0, 400000 


/sbus@1, £8000000/esp@0, 800000 
/sbus@1,£8000000/esp@0, 800000/st 
/sbus@1,£8000000/esp@0, 800000/sd 


Note: Sample display; contents may vary, depending on user input and the system used. 


The devalias command allows you to list all device name aliases currently 
defined and to define additional aliases. The new aliases are maintained in sys- 
tem memory; they are not kept in NVRAM and need to be re-entered whenever 
your system reboots or is shut down. 


Used alone, devalias lists aliases: 


ok devalias 

disk /sbus@1,£8000000/esp@0, £800000/sd 
tape /sbus@1, £8000000/esp@0, F800000/st 
net /sbus@1, £8000000/le@0, £800000 


Note: Sample display; contents may vary, depending on user input and the system used. 


To define a new device path name alias, use devalias with an alias 
specification: 


ok devalias alias device-path 


A number of environment parameters that control essential open boot PROM mon- 
itor functions are stored in NVRAM. These parameters can be examined, 
modified, and reset to factory defaults with the printenv, setenv, set- 
default and set-defaults commands. 


Used in the form 
printenv environment-parameter 


printenv displays the current value of the specified environment parameter 
and its original factory default value. 


Used alone, without specifying an environment parameter, printenv displays 
all current values for NVRAM environment variables and their original factory 
default values: 
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ok printenv 
Parameter Name Value Default Value 


name options options 
oem- logo 

oem-logo? false false 
oem-banner 

oem-banner? false false 
sbus-probe-list 0123 0123 
output-device screen screen 
input-device keyboard keyboard 
keyboard-click? false false 
keymap 

diag-file 

diag-device 

boot-file 

boot-device 

auto-boot? 

watchdog-reboot ? 

fcode-debug? 

screen-#columns 

screen-#rows 

sunmon-compat ? 

diag-switch? 


setenv Command Use setenv followed by the name of an environment parameter and a value to 
enter a new parameter value. For example, to change the current value of the 
parameter boot -device so that a client system default boots from its server, 
you would enter: 


ok setenv boot-device net 


set-default and set- The command set-defaults resets most parameters to their factory default 
defaults Commands values. The command set-default followed by the name of an environment 
parameter resets the specified parameter to its factory default value. 
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Bugs Fixed in SunOS 4.1.2 


Over 200 bugs have been fixed for SunOS 4.1.2. This chapter lists the more significant fixes, including CTE patches 
included in SunOS 4.1.2 (see Section 6.13). The bugs are listed in categories, and include the bug ID and a synopsis 
of the bug. The following categories are included: 


e Kernel 


e Network 


e SCSI 

e Graphics 
e Utility 

e = Library 


e Libsuntool 

e Sunview 

e Compiler/Loader 

e C2 

e Documentation 

e = Install 

e CTE Escalations 

e CTE OpenWindows Version 2 Patches 


6.1. Kernel 


1008324 TIOCCONS is a security hole 

1016767 /boot works for 1st disk controller only 

1029802 4/280 with xy451 panics: regs accessed while busy (patchid 100364-01) 
1032053 getreg should use fuword() when simulating instructions 

1032534 Kernel panics with panic: psig on exiting sunview 

1033861 Request an intelligent swap block freeing algorithm 

1036167 modified superblock may not be updated at unmount 

1036196 MLOCK/MUNLOCK broken 

1036449 modified superblock may not be updated at unmount 
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1037039 
1037052 
1037715 
1038651 
1038686 
1039275 
1039287 
1039410 
1039840 
1039846 
1039850 
1040722 
1042350 
1042808 
1043270 
1043801 
1044192 
1044666 
1044668 
1044888 
1045360 
1045582 
1046449 
1047295 
1047355 
1047586 
1048128 
1049010 
1049027 
1049125 
1050340 
1050540 
1050543 
1050546 
1050548 
1050558 
1051875 
1051876 


ufs_readdir hangs on a Olen entry 

shmdt(2) will not detach a read only segment 

ISO orderly release is not supported, but TCPTLI says so 

Using tmpfs ie ram /tmp can cause data initlztn w Fortran on 4.1 
System panics with "panic: hat_ptesync - invalid pme" message 
writing to an PROT_READ area is giving SIGBUS not SIGSEGV 
tcp/tli transport cannot send more than 4052 bytes of data 

putting default swap partition in fstab causes system crash, dump 
unmount doesn’t close block device 

unmount leaves metadata cached 

inode left locked on symlink creation 

Pseudo-ttys become attached to other users or hang 

tmpfs problem with ftruncate test in SCTS from SUNVS 
nopagereclaim erroneously set to 1 for Sun-4/4xx 

tmpfs disallows mmap beyond end of file 

panic: assertion failed, pmg->pmg_keepcnt == 

hard link to a directory succeeds on tmpfs for non-root users 
panic: ttcompat: unexpected ioctl acknowledgment 

umount/sync race can hang system 

Streams run out of dblks and hung the system 

spurious VME intrrpts cause kernel to panic: data f 

NeWSprint 1.0 hangs on 4/75 and 4/40 

multiple-register sbus cards don’t work on a 4/75 

mounting certain iso 9660 cd’s succeed but directory becomes data 
polling not working correctly 

mkfifo does not work on tmpfs 

xon flow control problems on serial i/o 

DLS60 kernel config file is incorrect. 

tmpfs hangs and deadlocks 

System panic’s when reject a network connection via TLI 
mmap(MAP_PRIVATE), madviseMADV_SEQUENTIAL) => panic: swap_xlate 
mount and sync can deadlock and hang the box 

umount can cause a iinactive panic 

putpage can hang the box 

nfs_putpage can hang the box 

Sparcstation 2 running SunOS 4.1.1 crashes under some applications 
mkfs can create an unusable file system 

system hangs when pageout sleeps in ufs_putpage 


1051983 buffer cache sz decreases w lg kernels causing high (patch 100330-02) 


1051992 
1052649 
1052669 
1053582 
1054054 
1054999 
1056058 
1056245 
1056992 
1056992 


pageout and clustering are not cooperating 

write system call is returning EINTR 

panic: data fault in strwrite - streams corruption 

mount/sync window causes panic: sleep 

+s and +t together do not work as expected 

syncip overhead in ufs_inactive causes poor NFS performance 
panic when writing to a >=2g-bsize file 

Process hangs in page_cv_wait, ufs_getapage after locking page 
4.1.1 leaks kernelmap 

4.1.1 leaks kernelmap (patch 100330-02) 
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1057211 
1057478 
1057481 
1057929 
1057963 
1060281 
1061174 
1063310 
1065858 
1066086 
1066422 
1066743 
1067681 
1068051 
1068283 
1068363 
1068462 
1068548 
1068907 
1068910 
1069072 
1070099 


VME master bus accesses can time out during heavy I/O 
access to non-existn mmap /dev/sbus cause panic: async memory err 
System hangs when running TLI 

sys hang: prestosrve and NC400 exhausting kernelmap (patch 100330-02) 
cannot mount an exported tmpfs directory 

pol1Q sys call gives bad returns for fd events 

poll does not return -1 when it receives a signal 

floppy driver reports drive as "unexpectedly busy" 

Cant run OW xinit on 4/670, 4/630 running 412A1.2 
4.1.2 kernel crashes under async I/O load, running MP 
performance enhancements for the sun4m IPI driver 
Track crosscall stats separately from intrrpt stats 

lockfs signal behavior may break applications 
profiling kernel support for sun4m 

vmstat reports incorrect numbers 

system crashes with 112mb memory and 128 maxusers 
kernel workaround needed for bugid 1067719 

PROM mailbox not properly mapped 

remove CDROM driver debug info 

Dump of data using /dev/sbus* device files broken 
Int div on sparc can be used to modify data 

support for removable disks got busted in 4.1.1 


6.2. Network 


1006905 add lock file to render rpc.yppasswdd sIngle threaded 

1034328 client can crash if two procs unlink (patchid 100173-06) 

1038060 ice0: WARNING: if_snd full error still noted 

1039326 vmunix : ieO : lost interrupt : resetting 

1041303 ifconf() off by one 

1045211 Problem with booting diskless clients 

1045531 Lock Mgr. suspends "file locking" processes indefinitely 

1045536 nfs exprts to non-sun sys can result (patchid 100173-06) 

1064433 Export of subtree doesn’t work (patchid 100173-06) 

1066287 nfs hang when looking at lg file changed on server (patchid 100173-06) 
1066663 SIGIO signal for async io fails to pend across NFS (patchid 100357-01) 


1029628 
1030884 
1034328 
1034750 
1037476 
1038302 
1038308 
1039406 
1039839 
1039977 
1041409 
1041559 
1042435 


setuid bit copied to NFS file system 

NFS full file sys gets ENOSPC even when overwriting existing file 
client can crash if two proc’s unlink the same file at once 
automount hangs while trying to open a mount point 

Sending bad proc to NFS server can cause mbuf leak 

NFS export option "anon=-1" does not work 

4.1 automount sets up a different sym link 5 mins after Ist access 
3960-3980th repeated sckt open & close fails w addr already in use 
nres_gethostbyaddr logs erroneous messages to NIS server’s console 
bug in the NFS DEBUG code, file nfs_export.c 

cannot execute setuid root programs in NFS mounted filesystem 
system is panicing in mclput 

client side noninterruptible hang 
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1043343 
1044565 
1045536 
1045700 
1045993 
1045995 
1045996 
1046001 
1046945 
1047557 
1048875 
1052330 
1052879 
1053552 
1053679 
1054669 
1057673 
1057685 
1057878 


increase arp table size 

pe-nfs client failed locking entire UNIX file 

NFS exports to non-sun systems can result in file truncation 

lockf fails when two processes try to read, write simultaneously 
NFS file caching still occuring on locked files 

unlink(2) on a file will prevent NFS file locks on the same file 
File locks are not removed on the server when a client is rebooted 
fcntl is interupted by signals and returns the wrong error code 
*ping’ caused machine to panic 

Old pages not being purged if file gets truncated on server 
Missing /etc/mtab file can fork the automounter 

locking on NFS file doesn’t cause cache purged after the 1st time 
panic iesynccmd with SunNet OSI 7.0 

ip_input drops pckts w IP opts as bad checksum w mclput pnc patch 
file region locking of NFS files was broken in 4.x 

telnetd allows password snooping 

panic: iinactive may result from klm code 

4.1.1 NFS servers freezing 

panic due to window in rtfree() 


6.3. SCSI 


1036481 
1042822 
1045071 
1045586 
1046305 
1046580 
1048141 
1049417 
1049674 
1049830 
1050067 
1051244 
1052613 


bsr after reading EOF doesn’t record space back, wrong pstn stat 
st: warning tape may be wearing.... on Exabytes 

sd: does not scan past 1 GB when using format utility 

Handling of special FORMAT command is broken w.r.t blkno decode 
some XXgetcap cases reversed 

bug in esp host adapter can cause panic during error recovery 
esp does not always recognize a marginal SCSI bus 

select phase not timed out causing indefinite hangs 

general bug report for some esp problems 

timeouts in polled mode cause a panic 

esp driver resource alloc fails when esp is child if dma 

SCSI Tape drive is misusing signals 

max dma limits set by host adapters are too small 


1052659 FSR on the old SCSI tape driver fails in 4.1.1 
1052888 st driver can cause a panic: zero divide trap 


1055184 
1058682 
1059139 
1062430 


3/2 sundev/sd.c uses only one buffer per unit 

Reassign block (format "repair") malfunctions beyond 1GB 
Accessing a SCSI tape drive causes system crash 

st drvr writes extra file mrks if opened then closed after writing 


1065300 front load tape doesn’t reliably read tapes 

1067300 st: soft errors sometimes cause loss of data 
1070535 esp: sync xfer rate is not renegotiated 

1070540 esp: incomplt cleanup after proxy msg causes panic 
1070876 delay after scsi bus reset required 


[various] 


improvements in st ioctl, EOF, EOT, EOM handling & status rprt 
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6.4. Graphics 

1045577 rasfilter_rgbtobgr always fails 

1046046 The colormap is not correct when 128 colors are used on 4.1.1 
1046327 P4 CG6 hardware cursor invisible under Sunwindows on OS4.1.1 
1063738 Diffuse positional lights on color-per-vertex tri 

1063743 Ambient positional lights for color-per-vertex 

1064295 Degenerate hollow triangles cause internal edge 

1066677 GT crashes w SunPHIGS Quick Update of batched polyl 
1066772 wide patterned polylines without vertex colours are 

1066851 gt config -™M flag doesn’t preserve VIDEO_ENABLE 
1066983 quick check pgm to visually test accel port to dev 

1067972 hi res version of cg!2 (gsxr) text is trash in pr_b 

1068136 gt config needs sync generator setup pgms for NTSC 
1068153 Leaf nodes which set no attributes cause QUM mode 

1068802 pixwin double buffer bug for GS 

1069396 gtconfig: sync generator pgm change needed for 

1069691 phigschild crashes GT system when huge application 

1070466 Setting hatch_transparency to false affects perf 

1071971 Get jitter when using 1280 @ 67hz video output forma 


6.5. Utility 

1016437 Ipd does not check file names for legality 

1022363 format: remove dummy defect list commit for embedded SCSI disks 
1025250 Zero-Ingth defect list causes format to fail extractn of mnfc... 
1030087 sendmail yp aliasing does not work with non-sun yp masters 
1031577 modload does not recognize the "vector" keyword 

1035625 not enough information on embedded scsi defect lists 

1036159 A user can run programs with root’s group privileges... 

1039221 bar core dumps w -x or -t option 

1045185 Disks are displayed in controller order but chosen in disk order 
1045636 4.1 /bin/mail problem delivering mail 

1047340 /bin/mail can be used to invoke a root shell 

1049010 DLS60 config file does not work 

1050675 Original, extract format command fails if defect count is zero 
1051638 format mode selects don’t support SCSI-2 page format 

1052805 Low-level format of MD21 disks usually fail with Warning... 
1053733 pax gets into infinite loop at EOT 

1055402 Bourne shell scripts using inline redirection and 

1058003 When reading from /dev/printer lpd does not check how much data it has read 
1058236 checksum error even with -c -i options 

1059212 Improvement needed in mode select error handling for SCSI disks 
1059225 Do not hardwire any SCSI disk mode select parameters 

1063772 possible to overwrite a file on system using lpr 

1067216 Format fails on 207mb maxtor drive 

1068402 mkfs should initialize UFS clean flag 

1068640 formatting CDC drives generates errors 
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6.6. Library 

1038500 localtime or tzsetwall corrupts malloc space (libc) 
1041074 The disk version of the "C" locale is incomplete 
1044722 undefined symbol in libxpg.a 


1044909 /usr/lib/expreserve race condition was used to break into a system 


1045471 


4.1(+) shared C libraries reference undefined symbols 


1050040 fcvtQ) segment faults under 4.1.1 
1051619 system() uses the system call fork() instead of vfor 


1051881 
1052398 
1052463 


1053346 There shouldnt be an imposed length limit for strings in strcoll() 


colldef rejects apparently valid input 
strxfrm is not 8 bit clean 
colldef can’t handle a substitute statement with hex numbers 


6.7. Libsuntool 


1038363 window_destroy does not release memory; 8k memory leak per textsw 


6.8. Sunview 


1028856 
1038313 
1039576 
1039760 
1040606 


2/2 master defaults database is not being read 
1/1 Can’t open and use more than 64 windows concurrently 


1/1 selection_svc and rpc can be used to gain access to system files 


3/2 notifier fails to handle fcntl for FNDELAY correctly 
2/3 selection_svc security problem 


6.9. Compiler/Loader 


NOTE: new compiler/loader in SunOS 4.1.2 includes substantial fixes that may affect some application programs. 
See “Link-editor Bug Fixes” in Chapter 2 for more detail. 


1019004 
1032208 
1032209 
1032739 
1033086 
1034788 
1034833 
1034844 
1037879 
1042261 
1043082 
1043300 
1044524 
1045194 
1045272 
1046379 
1046462 
1050594 
1052428 
1064820 
1069404 


-assert definitions can fail to report undefined symbols 

ldd doesn’t write file names if standard output is not a tty 

ldd runs out of file descriptors 

Id core dumps with many libs in mult. directories 

Calling dlopenQ( on a file with BSS kills your application 

-r and -pic do not mix bad secondary magic number on 4.1 

Id: can’t mixed -r with -Bstatic or -A flag in 4.1 

missing symbol from Id -r 4.1 object; exists in 4.0.3 ld output 
Cannot create executable w shared obj which points to another 
ld only recognizes first directory in LD_LIBRARY_PATH 
Bogus first arg to ’Idconfig’ kills dynamic linking 

diclose prevents access to functions even after further dlopen 
multiply defined symbols and seg. fault caused by 4.1’s Id 
dlsym returns bad addr for uninit global var in dlopened library 
Id -u & -r dont seem to work properly 

cant call a fnctn in a shared lib from a fnctn in another ... 

1d fails with seg fault proc nested incl 

Uninitialized struct slot causes intermittent failures 

Id.so usage of -L options confusing, leads to security problems 
1d can produce bogus diags with cascaded 

bad handle errors with dlsym(dlopen(NULL, 1),"xxx" 
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6.10. C2 

1040334 yppasswd wont allow user to change passwd from client..daemon dies 
1040465 The passwd -e command does not work when c2 security is in place 
1044204 rpc.passwdauthd can be used to guess passwords on c2 systems 
1047131 getauditflagschar() routine as distrib in 4.1 libc does not work 


6.11. Documentation 
1051880 colldef input format not documented 
1051882 semantics of colldef are unclear 


6.12. Install 
1041627 add_services can fail if partition changes are made after SunInstall. 
1047095 install from CD stops and complains if floppy is in 


1047696 Can’t boot 4.1.1 munix on a sun4c w/40mb of memory 
1063858 disk form takes 5 minutes to exit in a 40 disk machine 
1064779 dataless install corrupts file system 

1069645 should add support for keytables in munix 


6.13. CTE Escalations Fixed in SunOS 4.1.2 


Listed below are the Corporate Technical Escalations (CTE) patches which have been incorporated in SunOS 4.1.2. 
The list is in patch ID order and includes bug IDs and a synopsis of each fixed bug. 


100071-01 1038313 Can’t open and use more than 64 windows concurrently 
100072-01 1031577 modload does not recognize the "vector" keyword 

1038305 modload does not recognize the "vector" keyword 
100075-07 1044565 pce-nfs client failed locking entire UNIX file 

1045700 lockf fails when 2 procs try to read, write simultaneously 

1046001 fentl is interupted by signals, returns the wrong err code 

1045996 File locks not removed on server when a client is rebooted 

1045995 unlink(2) on a file prevents NFS file locks on same file 

1057673 panic: inactive may result from klm code 

1056300 failed tlock test #1: should ret EINVAL instead of success 

1061087 File /tmp./foo left on the server after a client reboot 

1061173 File record can be read-, write-locked by diff procs simul 
100085-03 1039576 selection_svc, rpc can be used to gain access to sys files 

1040606 selection_sve security problem 
100109-01 1032053 getreg should use fuword() when simulating instructions 
100125-04 1054669 telnetd allows password snooping 
100133-01 1036159 A user can run programs with root’s group privileges... 

1030087 sendmail yp aliasing does not work with non-sun yp masters 
100134-03 1042822 st: warning tape may be wearing.... on Exabytes 
100141-02 1039839 nres_gethostbyaddr logs erroneous msgs to NIS server’s cns 
100149-03 1041559 system is panicing in mclput 

1053552 ip_input drops pckts w IP opts as bad checksum w mclput pnc patch 
100159-01 1039406 3960-3980th repeated sckt open & close fails w addr already in use 
100168-01 1037747 crontab -e doesn’t update file edited in less than 1 setup_client 
100170-03 1034833 Id: can’t mixed -r with -Bstatic or -A flag in 4.1 

1034788 -rand -pic do not mix bad secondary magic number on 4.1 
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1044524 multiply defined symbols and seg. fault caused by 4.1’s Id 
1042261 1d only recognizes first directory in LD_LIBRARY_PATH 
1045272 Id -u & -r dont seem to work properly 
1037879 Cant create executble w shared obj which points to another 
1019004 -assert definitions can fail to report undefined symbols 
100173-03 1039977 bug in the NFS DEBUG code, file nfs_export.c 
1032959 NFSPROC_MKDIR returns incrr attrbutes 
1029628 setuid bit copied to NFS file systm 
1037476 Sending bad proc to NFS server can cause mbuf leak 
1038302 NFS export option "anon=-1" does not work 
1034328 client can crash if two proc’s unlink same file at once 
1045536 NFS exports to non-Sun systems can result in file truncatn 
1030884 NFS full file sys gets ENOSPC even wn overwrit exist file 
1045993 NES file caching still occuring on locked files 
1047557 Old pages not being purged if file truncated on server 
1052330 locking on NFS file doesn’t cause cache purged after Ist time 
1053679 file region locking of NFS files was broken in 4.x 
1041409 cannot execute setuid root pgms in NFS mounted filesystem 
100173-06 1034328 client can crash if two procs unlink 
1045536 nfs exprts to non-sun sys can result 
1064433 Export of subtree doesn’t work 
1066287 nfs hang when looking at lg file changed on server 
100174-01 1042350 tmpfs problem with ftruncate test in SCTS from SUNVS 
1038651 Using tmpfs ie ram /tmp can cause data initlztn w Fortran on 4.1 
1044192 hard link to dir succeeds on tmpfs for non-root users 
1043270 tmpfs disallows mmap beyond EOF 
1057963 cannot mount exported tmpfs directory 
1049027 tmpfs hangs and deadlocks 
1054054 +s and +t together do not work as expected 
1047586 mkfifo does not work on tmpfs 
100179-01 1047355 polling not working correctly 
100181-01 1039760 notifier fails to handle fcntl for FNDELAY correctly 
100186-01 1046945 ’ping’ caused machine to panic 
100188-01 1008324 TIOCCONS is a security hole 
100192-01 1046046 The colormap is not correct wn 128 colors used on 4.1.1 
100198-01 1037052 shmdt(2) will not detach a read only segment 
100199-01 1037715 ISO orderly release is not supported, but TCPTLI says so 
1039287 tcp/tli transport cannot send more than 4052 bytes of data 
1049125 System panic’s when reject a network connection via TLI 
1057481 System hangs when running TLI 
100201-01 1040465 passwd -e cmd doesn’t work when c2 security is in place 
1044204 rpc.passwdauthd can be used to guess pswrds on c2 systems 
1040334 yppasswd wont allow user to change passwd from client... 
1047131 getauditflagschar() routine in 4.1 libc does not work 
100203-01 1050040 fcvt() segment faults under 4.1.1 
100206-01 1038363 window_destroy does not release memory; 8k memory leak per textsw 
100207-01 1016767 /boot works for 1st disk controller only 
100208-01 1045471 4.1 (4+) shared C libraries reference undefined symbols 
100210-01 1028856 master defaults database is not being read 
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LOO7 L102 
IGO2ZL6=+01 
LOO 2 La 01: 
100224-02 


LOO22S-02 
LOO2Z25=02 
TO023 2-01 
10.0243-01 


100244-01 
100244-02 
100249-01 
100250=01 
LOO 2501 
100254-01 
LODZ Sood 
19025601 
LUG2Z5 1-02 


LOO2ZD 9-01 
100262-01 
100265-01 
100266-01 
LO0268-02 


LOOAT3S 201 
100275-01 


LO0261=01. 
100294-01 


L003 05=06 


1038050 
1046449 
1047295 
1047340 
1045636 
1048128 
1032534 
1050558 
1046580 
1048141 
1046305 
1052669 
LOSS 207 
1038308 
1052659 
1044909 
1044666 
1044888 
LOS3:/33 
1033086 
1043300 
1052428 
1046379 
1045194 
1032208 
1032209 
1043082 
1054999 
1052888 
1039215 
1038500 
1051880 
1051881 
1051862 
1051883 
1052463 
1053346 
LOS23.93 
1038686 
1043801 
LOS 21s 
1057685 
1056245 
LOS3992 
1051876 
1050546 
1045582 
1016437 
1058003 


if an "eom" ioctl] gets interrptd, tape synchronization lost 
multiple-register sbus cards don’t work on a 4/75 

mounting certain iso 9660 cd’s succeed but directory becomes data 
/bin/mail can be used to invoke a root shell 

4.1 /bin/mail problem delivering mail 

xon flow control problems on serial I/O 

Kernel panics with panic: psig on exiting sunview 

SPARCstation 2 running SunOS 4.1.1 crashes under some applications 
bug in esp host adapter can cause panic during error recovery 

esp does not always recognize a marginal SCSI bus 

some XXgetcap cases reversed 

panic: data fault in strwrite - streams corruption 

Frequent exhaustion of chanmap resource observed 

4.1 automount sets up a different sym link 5 mins after Ist access 
FSR on the old SCSI tape driver fails in 4.1.1 

/usr/lib/expreserve race condition used to break into a system 
panic: ttcompat: unexpected ioctl acknowledgment 

Streams run out of dbIiks and hang the system 

pax gets into infinite loop at EOT 

Calling dlopenQ on a file with BSS kills your application 

diclose prevents access to functions even after further dlopen 
Id.so usage of -L options confusing, leads to security problems 
cant call a fnctn in a shared lib from a fnctn in another ... 

disym returns bad addr for uninit global var in dlopened library 
Idd doesn’t write file names if standard output is not a tty 

Idd runs out of file descriptors 

Bogus first arg to “Idconfig’ kills dynamic linking 

syncip overhead in ufs_inactive causes poor NES performance 

st driver can cause a panic: zero divide trap 

writing to an PROT_READ area is giving SIGBUS not SIGSEGV 
localtime or tzsetwall corrupts malloc space (libc) 

colldef input format not documented 

colldef rejects apparently valid inpt 

semantics of colldef are unclear 

spelling error in colldef message 

colldef can’t handle a substitute statement with hex numbers 
There shouldnt be an imposed length limit for strings in strcoll() 
strxfrm is not 8 bit clean 

System panics with "panic: hat_ptesync - invalid pme" message 
panic: assertion failed, pmg->pmg_keepcnt == 

VME master bus accesses can time out during heavy I/O 

4.1.1 nfs servers freezing 

Process hangs in page_cv_wait, ufs_getapage after locking page 
pageout and clustering are not cooperating 

system hangs when pageout sleeps in ufs_putpage 

putpage can hang the box 

NeWSprint 1.0 hangs on 4/75 and 4/40 

Ipd does not check file names for legality 

Reading from /dev/printer, lpd does not check how much it has read 
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1903S 23=01 
1003:30=02 


100346-01 
100349-02 
100356-01 
L003 57> 0A 
100364-01 
1003-76-01. 
LB03 76-02 


1063772 
1044668 
LOS EISGS 
10569382 
1057929 
1044722 
ATE G73 
1067615 
1066663 
1029802 
1069072 
1069702 


possible to overwrite a file on system using lpr 
umount/sync race can hang system 

buffer cache sz decreases w lg kernels causing high 

4.1.1 leaks kernelmap 

sys hang: prestosrve and NC400 exhausting kernelmap 
undefined symbol in Libxpg.a 
K_PICK_ECHO_STRUCT_EN_RANGE_PLUS_DESCENDANTS may stop echoing in a descendant 
kernel hangs while processing aiocancel system call 
SIGIO signal for async io fails to pend across NFS (patchid 
4/280 with xy451 panics: regs accessed while busy 

Int div on sparc can be used to modify data 

Integer division on SPARC can be used to gain root access 


6.14. CTE OpenWindows Version 2 Patches 


Patch-ID# 100131-01 Synopsis: Custom CADENCE xnews server with two bug fixes Bugs Fixed: 1043582 popup 
windows cause damage if the are partially off screen. 1043824 Intermittent failure to deactivate automatic pointer 


grab. 


Patch-ID# 100156-01 
Synopsis: xauth sets wrong hexkey data in the add displayname option 


Bugs Fixed: 


1045483: xauth sets wrong hexkey data in the add displayname option 


Patch-ID# 100158-01 
Synopsis: xview notifier cannot handle number of files > 31 


Bugs Fixed: 


1040844: xview notifier cannot handle fildes > 31 


Patch-ID# 100166-01 
Synopsis: PANEL_SLIDER SEGVs when slider bar is moved - monochrome only. 


Bugs Fixed: 


1042937: PANEL_SLIDER SEGVs when slider bar is moved - monochrome only. 


Patch-ID# 100176-08 
Synopsis: OpenWindows 2.0: Patch release 8 for X11-NeWS server 


Bugs Fixed: 


1040959 - odd line widths identical to even widths (5==4) shapes bug. 
1043824 - Intermittent failure to deactivate automatic pointer grab. 
1043582 - popup windows cause damage if the are partially off screen 
1041986 - XGetImage will crash server if planemask is set to AllPlanes... 
1043914 - CharStrings does not contain entries for unencoded characters. 
1044043 - pointer grabs generate incorrect enter/leave events. 

1044086 - incorrect rendition of some stroke characters NeWS bug. 
1044246 - killing a client while the server is grabbed causes SEGV 
1044315 - The server can get into an infinite loop and consume cpu time 
1044475 - XDrawArc doesn’t draw large circles correctly 

1045150 - R to L copies less than one longword. 
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1046997 - server hangs if button event generated when socket is full 
1045563 - XDrawLine with negative points crash the server 
1045650 - Bad pixmaps are created and NO ERROR is returned.... 
1045652 - Creating 100 to 200 pixmaps causes the server to crash 
1045857 - FrameMaker 2.1X crashes server 

1045887 - cgsix, sparc station, server crashes on XDrawSegment 
1047358 - KeymapNotify events being generated in the wrong order. 
1047494 - NeWS line > 1 cap style CapRound, caps hanging bug. 
1048120 - NeWS line > 1 not drawn correctly if cap style CapRound. 
1050109 - Line Width > 1 not drawn correctly. 

1051287 - DGA leaves file descriptor open for color map. 

1051689 - Short rlineto lose accurate current point for wide lines. 
1051848 - Plane masking bug. 

1052157 - xcs_clear sh_mem_fill clear region server crash. 


1052239 - sh_Shape_Raster() bad calculation memory corruption core dumping. 


1052479 - Out of bounds framebuffer access. 

1052697 - Out of bounds framebuffer access. 

1052712 - NeWSPrint imagecanvas boundaries rounding bug. 
1052749 - Shapes bad calculation memory corruption core dumping. 
1052822 - Out of bounds framebuffer access. 

1053164 - Fill operator causes dropouts of Type 3 Fonts. 

1053342 - Visibility Notify not received when window partially obscured. 
1053511 - Windows over 32000 pixels BadAlloc shapes bug. 
1053954 - Visibility Notify enabled impacts server performance. 
1054009 - Set screen saver bug. 

1054362 - Postscript accentuated characters disappear text shifts. 
1054811 - NeWS Lotus graphs not rendering right and bottom lines. 
1054918 - XNeWS would not render 256 colors. 

1055187 - XFillRectangle on a cg3 stipple incorrect results. 

1055265 - Plaid OW demo crashes LSCrev2 legosc 

1055656 - XSetFillStyle FillTitled stipple fill incorrect. 

1055672 - Pageview does not display Postscript document correctly. 
1056088 - Protect the server from out of framebuffer accesses. 
1056131 - Closepath doesn’t produce a line join if last element zero length. 
1056324 - NewsPrint Sparc Printer Bad Line Widths. 

1056454 - Frame on OWV2 can crash legosc quadro systems. 
1057110 - LSC Rev 2 chip has bug in frame buffer arbitration. 
1057234 - XGL and server graphics can crash legosc. 

1057502 - Doubledash lines not rendered when rop set. 

1057750 - xcs_clear xcsProcs shapes fill area needs range clipping. 
1058592 - XSetClipRectangles inconsistent clipping action bug. 
1058818 - xc_create_transmem_raster not clipping child raster to fit parent. 
1059182 - Postscript file will not render properly. 

1059186 - Postscript line drawing and rendering bug. 

1059230 - SparcPrinter won’t print excel postscript files. 

1059933 - Can’t printout NeWSprint characters are upside down. 
1060093 - Stippling and clipping not displayed correctly. 

1060964 - colormap corruption server core dump when running props. 
1061098 - X11 wide lines coincident first & last points not joined. 
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1061305 - XDrawArcs test in MIT Xlib test crashes xnews server. 
1061436 - xnews return wrong Fontmatrix on redefined font PostScript bug. 
1061881 - do not return per character metrics for fixed size fonts. 
1062574 - Window grabber clip problem cv_unmap. 

1062616 - pageview will send xnews process into an infinite loop 
1062834 - events open declaration syntax error. 

1063240 - docviewer intro screen corrupted after installing xnews patch. 
1063261 - cv_reshapecanvas to send expose properly. 

1063464 - ListFontsWithInfo slow performance. 

1063821 - window mapping bug. 

1069548 - poor performance of XQueryFont 

1069590 - xnews server crashes after allocating 216 colors 


Also fixed (no bugid’s): 
- Tile and Stipple related bug fixes. 
- XGetImage ZPixmap transfered whole raster error. 
- Shape_Obj excessive local temporary shapes being created. 
- DragAndDrop cursor does not appear. 
- Snaptool does not work correctly. 
- AnswerBook does not display pages correctly. 
- Performance enhancements for font queries 
- psterm title bar does not repaint after resizing 
- IslandDraw core dumps at startup time 
- VideoPix’s vfctool dies with X error 
- Mwg does not repaint root window correctly 


Patch-ID# 100183-01 

Synopsis: Openwin 2.0:rescale font to 60pt size and convert to vfont doesn’t work 
Bugs Fixed: 

1045767: when you rescale folio font to 60pt size and convert to vfont, it dent work 


Patch-ID# 100184-02 

Synopsis: sv_xv_sel_svc and rpc can be used to gain access to system files 
Bugs Fixed: 

1040747: sv_xv_sel_sve and rpc can be used to gain access to system files. 


Patch-ID# 100205-01 

Synopsis: Highligting problems within filemgr running on Xterminals. 
Bugs Fixed: 

1045939: filemegr incorrectly inverts icons on a NCD mono X terminal 


Patch-ID# 100213-01 


Synopsis: Application core dunps when user selects text item and drags it on the scrolling list. 


Bugs Fixed: 
1047260: drag text field into scroll list causes app. core dump 
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Patch-ID# 100231-01 

Synopsis: PANEL_LABEL_WIDTH does not set button size correctly. 
Bugs Fixed: 

1037262: PANEL_LABEL_WIDTH doesn’t work 


Patch-ID# 100245-01 

Synopsis: olwm banding bug, label centering bug 

Bugs Fixed: 

1038716: Olwm window labels are not always centered properly. 

1047748: Olwm can get into the "move window" rubber banding mode by mistake. 
1055511: Olwm save workspace only works for WM_SAVE_YOURSELEF clients. 
1053101: Olwm XV_SHOW fails when DISABLED and ENABLED quickly. 


Patch-ID# 100246-01 

Synopsis: panel buttons fail when multiple server connections are made. 
Bugs Fixed: 

1041574: panel buttons fail when multiple server connections are made. 


Patch-ID# 100247-01 

Synopsis: Xview libraries multiple bug fixes. 

Bugs Fixed: 

1051808: Control panel with a scrolling list sometimes displays wrongly sized. 
1048055: Canvases and control areas < 2 pixel apart draw in wrong size. 
1028072: xv_set for scrolling lists has side effects. 

1046128: Non-exclusive menus calling wrong notify proc when item selected. 
1045626: Can’t specify different font for each panel item. 

1049478: Panel buttons only inherit panel fonts conditionally. 


Patch-ID# 100352-01 

Synopsis: bldfamily, convertfont & makeafb compress fontnames causing conflicts 
Bugs Fixed: 

1043430: convertfont & bldfamily default filename length too small 

1052174: bldfamily should handle font name conflicts better 


Patch-ID# 100354-02 
Synopsis: cm displays NoName as user if user has a "-" in it’s name 
Bugs Fixed: 


ott 


1046847: cm comes up with NoName displayed as user if user has a "-" in it’sname. 


Patch-ID# 100355-01 
Synopsis: OpenWindows 2.0: patch for panel text item bug 
Bugs Fixed: 


1065873: PANEL_VALUE_DISPLAY_LENGTH in text item does not work for values les than 4 
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Patch-ID# 100366-01 

Synopsis: filemgr does not handle automounted directories correctly 

Bugs Fixed: 

1043301: subdirectory mounts don’t work with hierarchical mounts 
1040123: indirect maps creates symbolic links inconsistently with subdirecto 


Patch-ID# 100367-01 


Synopsis: Cursor advances too far when using compose key in OLIT 2.5 appl. 


Bugs Fixed: 
1067129: TextEdit widget does not insert 8-bit characters correctly 
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Part 3 — Installation and System 
Configuration 


Part 3 includes the following chapters: 


Chapter 7, “Installation Notes and Warnings” 


Chapter 8, “System Configuration” 


Part 3 — Installation and System Configuration — Continued 


7.1. 


12; 


7.3. 


Upgrade Utility 
Available 


Do Not Install Earlier 
Patches to SunOS 4.1.2 


Installing Unbundled 
Products on a Server 
Supporting Multiple 
Releases 


Installation Notes and Warnings 


Be sure to read this chapter before proceeding with installation of SunOS 4.1.2. 


This chapter provides information about the installation of SunOS 4.1.2, includ- 
ing warnings about OpenWindows restrictions. It also contains information 
about installation of unbundled products, including warnings about the incompa- 
tibility of some versions of these products with release software or other Sun pro- 
ducts. 


SunOS 4.1.2 includes sunupgrade, a utility for upgrading from SunOS 4.1.1 
or SunOS 4.1.1 Rev B to SunOS 4.1.2. See Installing SunOS 4.1.2 System 
Software for a description of the upgrade procedure. 


Many patches that were needed in SunOS 4.1.1 and SunOS 4.1.1 Rev B have 
been included in SunOS 4.1.2. Check with your local Sun Support center if you 
are unsure if a particular patch has been included in SunOS 4.1.2 or to see if a 
SunOS 4.1.2 version of the patch is available. 


Do not install any patches from earlier releases after installing SunOS 4.1.2; this 
may cause your system to crash. 


Clients running a different release than their server do not have access to unbun- 
dled products installed in directories belonging to the server’s release. In some 
cases, this means that cdmanager or ext ract_unbundl1led, the installation 
tools for unbundled products, has to be run separately for each release. In other 
cases, a workaround of several steps may be necessary in order to make a product 
available to a client. 


Unbundled products are loaded on a system using cdmanager or the 
extract_unbund1ed installation script. For many products, the script 
allows the user to specify the receiving directory. When this is the case, 
cdmanager or extract_unbundled can simply be run more than once to 
install a given product in different release directories. 
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For some products, however, the receiving directory is hardcoded into 
cdmanager or extract_unbundled. In such cases, cdmanager or 
extract_unbundled will load a product in a directory belonging to the 
server’s release, where it is not available to clients running under a different 


release. 
Workaround to Install The following workaround shows how to install language products so that they 
Language Products for a are accessible to clients running a different release from their server. The same 
Client’s Release approach can be applied to other products whose paths are hardcoded in 


cdmanager or extract_unbundled. 


The workaround uses the example of a sun4c client running SunOS 4.1.2 ona 
Sun-4 server running under SunOS 4.1.1. All language products belonging to the 
server’s application architecture are loaded into the server’s /usr/ lang direc- 
tory. It is assumed that ext ract_unbund1led has already been run to install 
language products on the server. A partial file listing of the server’s 
/export/exec directory shows: 


3 kvm 

9 proto.root.sunos.4.1.1 

9 proto.root.sunos.4.1.2 
drwxr-sr-x 3 : sun3 

de 

1 

9 


drwxr-Sr-xX 
drwxr-Sr-xX 
drwxr-Sr-xX 


sun4 -> /usr 
sun4.sunos.4.1.1 -> /usr 
sun4.sunos.4.1.2 


lrwxrwxrwx 
lrwxrwxrwx 
adrwxr-sr-x 2 


To install a language so that it is accessible to a client running a different release 
than its server: 


1. Halt all processes on systems belonging to the server’s release and the 
client’s release that might try to access binaries in the server’s /usr/lang 
directory. In this example, halt all sun4 and sun4c clients. 


2. Change directories so that you are in the server’s receiving directory. In this 
case: 


3. Change the name of the language directory: 


# mv lang lang -old - 


4. If you do not already have a directory for receiving the product on the client 
system, set it up now. For example: 
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7.4. OpenWindows Version 
2 Restrictions 


Do Not Install Sun IPX 
Supplement 


OpenWindows Does Not Fit 
on 104MB System Disks 


8MB Main Memory, 20MB 
Swap Partition, Required 


% 


S 


# mkdir /export/exec/sun4.sunos.4.1.2/lang 


(TED 
Ni 


5. Create a link to the client directory that is to receive the product: 


# In -s /export/exec/sun4.sunos4.1.2/lang /export/exec/sun4/lang 


6. Use extract_unbund1led to install the product. 


7. Remove the link from /export/exec/sun4/lang to the client’s 
receiving directory: 


8. Restore the original language directory whose name you changed: 


# mv lang.old lang | 


OpenWindows Version 2 and OpenWindows Version 3 are described in Chapter 
3. Note the following about OpenWindows Version 2 before you begin installa- 
tion of the release. Also, see Chapter 10 in the Open Issues package for descrip- 
tions of OpenWindows bugs. 


This patch has been incorporated in the OpenWindows Version 2 included with 
SunOS 4.1.2; the patch is unnecessary. Do not install it. 


OpenWindows requires over 30MB of disk space. This is more than will fit on a 
104MB disk loaded with even a minimal version of SunOS4.1.2. See “Desktop 
SPARCsystem with Two 104MB Disks: Using Second Disk for /home and 
Additional Swap Space” and “Desktop SPARCsystem with Two 104MB Disks: 
Using Second Disk for OpenWindows” in Chapter 8 for descriptions of the 
methods for using a second 104MB disk for either /home or for OpenWindows. 


In order to run OpenWindows, your system must have at least eight megabytes of 
main memory. Twelve megabytes or more are recommended. 


Before installing OpenWindows software on your system, you need to make sure 
that your swap partition is at least 20MB; 24MB or more is recommended. 
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OpenWindows Requires 
SunView Libraries In Order 
to Run 


7.5. Graphics: 


7.6. Hardware Patches 


Do Not Install SunOS 4.1 
Patch for Running 
SPARCprinter on 4.1.2 
System 


oN 
et 


Do Not Install Sun 1.3GB Disk 
Enhancement 


Sun 


In order to run OpenWindows, you must have the SunView_Users software 
category installed on your system. SunView_Users contains libraries needed by 
OpenWindows. Without SunView, you get the message: 


ld.so: libsuntool.so.0.## not found 


A special patch tape (SunOS 4.1 GFX Rev 1) was provided for running GFX 
graphics under SunOS 4.1; two patch tapes (SunOS 4.1.1 GFX Rev 1 and SunOS 
4.1.1 GFX Rev 2) were provided for running GFX graphics under SunOS 4.1.1. 
SunOS 4.1.2 now incorporates the contents of these tapes. 


If you install SunOS 4.1.2 and then try to install any of the SunOS 4.1 or SunOS 
4.1.1 GFX patch tapes, you will crash your system. 


The Read This First (RTF) with Sun’s SPARCprinter instructs the user to install 
a patch for running the printer under SunOS 4.1. The patch is now incorporated 
in SunOS 4.1.2 and the RTF’s instruction should be disregarded. 


If you install SunOS 4.1.2 and also try to install the patch from SunOS 4.1 you 
will destroy your kernel and crash your system. 


A special patch was provided for Sun-4 systems running SunOS 4.1.1 and Sun-4c 
systems running SunOS 4.1.1 Rev B, to enable use of the 1.3GB disk on these 
systems. The changes have been incorporated in SunOS 4.1.2; the patch is 
unnecessary. Do not install it. 
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7.7. Prestoserve 2.0 and 2.3 


Error Message During 
Prestoserve 2.3 Installation 


Prestoserve 2.0 Sundiag 
Problem (1067352) 


7.8. NSE 1.2 not 
Compatible with 
SunOS 4.1.2 


7.9. Sun DBE 1.0 and 1.1 
Not Supported under 
SunOS 4.1.2 


7.10. Sun Cross Compilers 
3.0 Not Supported 
under SunOS 4.1.2 


7.11. SunTrac Tutorial 
Date Errors 


sun 
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Prestoserve 2.0 has been superceded by Prestoserve 2.3, which only supports 
Sun-4c and Sun-4m machines. If you have a Sun-4 machine, you can continue to 
use Prestoserve 2.0 with SunOS 4.1.2. 


During installation of Prestoserve 2.3 on a SunOS 4.1.2 system, the following 
message sequence will be displayed: 


2.3_Prestoserve : This software is not compatible with the 


current operating system 


This is the list of compatible operating systems: 
7. Saal areal 


Do you want to continue? [yln] 


Respond “‘y” and Prestoserve 2.3 will be successfully installed. 


The Sundiag menu for Prestoserve 2.0 shows both a user test and device test for 
Prestoserve. Run only the device test. 


Do not use NSE (Network Software Environment) Release 1.2 on a system run- 
ning SunOS 4.1.2. If you run NSE 1.2 under SunOS 4.1.2, it will corrupt some 
system files and may cause a system failure. This problem is corrected in NSE 
1.2.1 and subsequent releases. 


Do not use SunDBE 1.0 or SunDBE 1.1 with SunOS 4.1.2; they are not sup- 
ported and they will not work. 


Do not use Sun Cross Compilers 3.0 with SunOS 4.1.2; it is not supported. 


The SunTrac tutorial program contains reference to a Play, that has its starting 
date on 01/01/90. Since the real date is now greater than that date, a feature of 
the product is activated which requires the user to modify a considerable number 
of dates in the Tutorial. This can hinder testing considerably and create docu- 
mentation errors. The Clear Date Error menu item will clear the date 
errors each time they are encountered. 
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7.12. SPE 1.1 Problems 


SPE Build Failure 


Stack Overflows 


7.13. SunShield 1.0 on 
SunOS 4.1.2 


The following two problems may be encountered running SPE 1.1 under 
SunOS 4.1.2; the first problem has been fixed in SPE 1.2. 


If SPE 1.1 is built (using the $SPE_ROOT_DIR/build-spe script) under 
SunOS 4.1.2, it will fail after trying to write the SPE image to a nonexistent 
directory. That directory will be either 


SSPE_ROOT_DIRECTORY/sun3-unknown 
or 
SSPE_ROOT_DIRECTORY/sun4-unknown 


depending on the application architecture of your system. 


There are two ways to avoid this problem. The first solution is to link the nonex- 
istent directory to 


SSPE_ROOT_DIRECTORY/sun3-4.0 
or 
SSPE_ROOT_DIRECTORY/sun4-4.0 


(whichever is appropriate to your system). 
Alternatively, you can edit the $SPE_ROOT_DIRECTORY/os shell script, 
changing 


/SunOS Release 4.0/ 
to 
/SunOS Release 4./ 


The second SPE problem is caused by stack overflows, which may cause the Lisp 
process to die. Specifically, overflowing the stack and then, without first unwind- 
ing the stack, overflowing it again (recursive stack overflows) will kill your sys- 
tem. Avoiding these stack overflows, especially recursive stack overflows, will 
prevent this problem. 


To install SunShield 1.0 after installing SunOS 4.1.2, you must extract the patch 
from the SunOS 4.1.2 CD-ROM, as described below. 


1. Insert the SunOS 4.1.2 CD-ROM into the drive. 


2. Unmount the CD-ROM if it is mounted: 


# ca / 


umount /dev/ sr0 


3. Runextract_patch: 


# /usr/etc/extract_patch -parm_1_0 


4. Change to SunShield (“‘arm’’) directory and untar the patch: 
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# cad /usr/tmp/arm_1_0 
# install _ arm 1 _0 


5. Respond y to question: 


You need a ARM/ASET CD to continue. 


Do you still want to continue [y|ln]? y 


6. Respond y when asked if CD is inserted : 


Please insert the ARM/ASET CD. 
Is the CD inserted? [yl:y 


7. Designate cdmor cdmanager as the tool to use: 


Which tool do you want to use? 


You can use cdm whether or not you are running OpenWindows; you must 
be in OpenWindows to run cdmanager. Follow the self-explanatory 
prompts to complete the installation of the patch. 


7.14. SunNet/SunLink When installing some 6.0 and 6.1 SunNet/SunLink products, you must run the 
Networking Products /usr/etc/sunlink.instal]l script after you run 
extract_unbund1led, but before you run any product-specific installation 
scripts. If you do not run sunlink.install first, the product-specific instal- 
lation scripts fail. 


The new installation steps are as follows: 


1. Run /usr/etc/extract_unbund1led to extract the product off the 
tape. 


2. Run /usr/etc/sunlink.instal1, selecting the product being 
installed. 


3. Run any product-specific installation or configuration scripts according to 
the product documentation. 


The following list indicates the affected SunLink products. Note that some of the 
products in the list have been superseded by later versions, which may not cause 
any installation problems. 
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Installing the Internetwork 
Router 


Exporting SunLink Software 
for Multiple SunOS Versions 


BSC3270 

BSCRJE 

Channel Adapter 
DDN 

DNI* 

ASt 

INR* 

MCP* 

SNA3 270 
Peer-to-Peer 


NDDDAD AD As VD A 
OrFoODTOUO OO 00 F 


*There may be additional steps for these products. See the next sections for 
details. 


If you are installing the SunLink Internetwork Router on a system that is running 
SunOS 4.1.2, you must perform the following step: 


After you run the ext ract_unbundled and sunlink.install1 scripts, 
but before you run the install.inr script, enter the following command as 
root: 


where arch is a directory name that designates your machine architecture, for 
example, sun4 for a Sun-4. You can then proceed to run install.inr as 
documented in the SunLink Internetwork Router System Administration Guide. 


When you install SunLink software, the installation script installs the software 
only in the hierarchy for the SunOS version that the machine receiving the instal- 
lation is running. That is, if you install on a machine running SunOS 4.1.2, the 
SunLink software goes into the hierarchy for 4.1.2. If that machine is a server 
that has diskless clients that are running different SunOS versions from the 
server’s and that require access to SunLink software, you must do the following: 


e Create a sunlink mount point at the end of the version-specific hierarchy 
that the client mounts on /usr. 


e Edit the client’s fstab file so that the client mounts the hierarchy where the 
SunLink product was installed on the newly-made mount point. 
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For example, assume you have a Sun-4 server running SunOS version 4.1.2 that 
serves diskless Sun-4s running SunOS 4.1.2 and SunOS 4.1.1. Your 4.1.1 clients 
mount one hierarchy as /usr: 


/export/exec/sun4.sunos.4.1.1 


while your 4.1.2 clients mount a different hierarchy as /usr: 


/export/exec/sun4.sunos.4.1.2 


After you install SunLink software on the server, it is available as: 


/usr/sunlink/<product_name> 
/export/exec/sun4/sunlink/<product_name> 


/export/exec/sun4.sunos.4.1.1/sunlink/<product_name> 


To allow your 4.1.2 clients to access the SunLink software, use the following 
commands to create the mount point sunlink: 


Note that the hierarchy /export/exec/sun4.sunos.4.1.2 is already 
mounted as /usr on the 4.1.2 clients. In the fstab for these clients, add an 
entry so that /export /exec/sun4.sunos.4.1.1/sunlink (the hierar- 
chy that contains SunLink software) is mounted on the newly created mount 
point /usr/sunlink after the /usr entry, for example: 


<server>: /export/exec/sun4.sunos.4.1.2 /usr nfs ro 0 0 


<server>:/export/exec/sun4.sunos.4.1.1/sunlink /usr/sunlink nfs ro 0 0 


setsid Problems When If you install SunOS 4.1.2 on a machine running SunLink DNI 6.0, you must 

Running SunLink DNI 6.0 provide a “wrapper” around the DNI virtual terminal daemon (dnilogind) so 
that it conforms to the POSIX- standard requirements for acquiring a controlling 
terminal. This problem does not exist with DNI 7.0. 


To allow a Sun node to remain accessible via SunLink DNI whena set host 
command is issued on a VAX/VMS¥F system, as root, enter the following com- 
mands after DNI installation is complete: 


+ VAX and VMS are trademarks of Digital Equipment Corporation. 
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setsid Problems When 
Running SunLink X.25 6.0 


Incorrect Instruction in 
SunLink BSC3270 System 
Administration Guide 


(1044933) 


# cd /usr/sunlink/dni : | 
# mv dnilogind .dnilogind 

# Cat > dnilogind 

#!/bin/sh 

/usr/etc/setsid -b /usr/sunlink/dni/. dnilogind "gan 
“DD 


# chmod a+x dnilogind 


It is not necessary to reboot your machine. 


For background on the reasons for this requirement, see the man page on 
setsid (8V). 


If you install SunOS 4.1.2 on a machine running SunLink X.25 6.0, you must 
provide a “wrapper” around the X.29/X.3 server (x29) so that it conforms to the 
POSIX- standard requirements for acquiring a controlling terminal. This is fixed 
in X.25 7.0 and subsequent releases. 


As root, enter the following commands after X.25 installation is complete: 


# ed /usr/sunlink/x25 
# mv x29 5 

# cat > 429 
#!/bin/sh - 


es -b {USE (Sunt S/H e OT: x29 "Se" 
"Dd 
# chmod atx x29 


It is not necessary to reboot your machine. 


For background on the reasons for this requirement, see the man page on 
setsid (8). (This man page is not present in previous SunOS versions.) 


On page 35 of the SunLink BSC3270 System Administration Guide the instruc- 
tions for booting from the newvmunix kernel are incorrect and will generate 
incorrect output from a number of subsequent commands. The correct instruc- 
tions are: 


1. Copy the new kernel, newvmunix, to the root (/) directory. 


2. Change the name of the original vmunix kernel to vmunix.old and 
change newvmunix to vmunix: 


mv vmunix vmunix.old 


mv newvmunix vmunix 


3. Reboot your system 
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7.15. Language Products 


Sun C++ 2.1 Patch 
Installation 


Where is the Sun C++ Patch 
Installed? 


Preparing for Patch Installation 


Patch Installation to Default 
Directory 


sS 


The following topics are described in this section: 

e Sun C++ 2.1 Patch Installation 

e FORTRAN 1.4 Patch Installation 

e Pascal 2.1 Patch Installation 

e FORTRAN, C, Pascal, Modula-2: Missing Debugging Libraries 
e FORTRAN 1.2 Problems 


SunOS 4.1.2 introduces new library functions and system calls. For Sun C++ 2.1 
to run under SunOS 4.1.2 you must install a patch. This section describes how to 
install the patch. 


The patch includes the following: 
e A README file, 
e The patch installation script 


e A directory with header files for SunOS 4.1.2. 


Install the patch in the directory in which Sun C++ 2.1 was previously installed. 

The default is /usr/lang for standalone and homogeneous servers. You may 
also specify a non-default directory as the installation directory. Just make sure 

it exists and that you have already installed Sun C++ 2.1 in it; otherwise, the ins- 
tallation script will not allow you to install the patch. 


The patch script will alter the original SC1 .0/include/Cc header file direc- 
tory, and some of the original SC1.0/include/CcC header files will be lost. 


Install or upgrade to SunOS 4.1.2 and Sun C++ 2.1 before you install the Sun 
C++ 2.1 patch. 


If you do not understand the terms used here, see the installation instructions in 
the Sun C++ 2.1 Read This First. 


If you are installing on a standalone workstation and using the default installation 
directory, you may use default installation directions. If you are going to install 
the software onto a server, follow the non-default installation directions. If you 
need additional information, see the man page for ext ract_patch(8). 


After installing SunOS 4.1.2 and C++ 2.1 from the SunOS 4.1.2 CD-ROM, do the 
following to install the C++ patch in /usr/lang, the default installation direc- 
tory for C++ 2.1. 


1. Insert the SunOS 4.1.2 CD-ROM into the CD-ROM drive and mount the 
CD-ROM. 
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2. suto root and extract the patch directory by typing the following on a 
command line: 


The script will extract the patch files from the CDROM; if the default desti- 
nation, /usr/lang, exists and contains the directory 
SC1.0/include/CC, the script will display the README file and ask if 
you want to continue: 


Ready to install C++ 2.1 patch for 4.1.2 in /usr/lang 


Do you want to continue: [fyln]? 


Sun C++ 2.1 should now work under SunOS 4.1.2; if it does not, contact your 
local Sun Answer Center. 


Patch Installation to a Non- After installing SunOS 4.1.2 and C++ 2.1 from the SunOS 4.1.2 CD-ROM, do the 
Default Directory following to install the C++ patch to a directory other than /usr/1lang, the 
default directory. 


1. suto root and extract the patch directory by typing the following on a 
command line: 


The script will extract the patch files from the CDROM, display the 
README file, and ask you whether you want to execute the patch installa- 
tion program. Enter y. 


2. Reply y when asked if you want to see a description of the patch script: 


3. If you are installing the patch on a machine that is running on SunOS 4.0, 
4.1, or 4.1.1 you will see the following message: 
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FORTRAN 1.4 Patch 
Installation 


WARNING: This patch script is for Sun OS 4.1.2 
You are running it on Sun OS 4.0 or 4.1 or 4.1.1 


Do you want to continue anyway [y|n]? 


Enter y if you are installing the patch into a server running on SunOS 4.0, 
4.1, or 4.1.1 that will support machines running on SunOS 4.1.2. 


4. Respond to the script’s questions about what type of system you have (stan- 
dalone or server), what type of server (always choose homogeneous), and 
what type of client will the product run on (sun4 only). 


After you answer the questions, the script will display the default Sun C++ 
2.1 directory for your configuration: 


Currently the default C++ 2.1 directory is /usr/lang 


Do you want to change the default directory [yln]? 


5. Enter nif the default directory is correct. Enter y if you want to specify a 
different directory. You will then be asked to type in the name of your ins- 
tallation directory. 


6. See Step 2 under the “Default Patch Installation,” the script will continue in 
the same manner. 


Sun C++ 2.1 should now work under SunOS 4.1.2; if it does not, contact your 
local Sun Answer Center. 


Install the FORTRAN patch in the directory where FORTRAN is installed; 
/usr/lang/SC1.0 or /usr/lang/SC1.0.1 is the default location. You 
may also specify a non-default directory as the installation directory. Just make 
sure it exists and that you have already installed SC1.0 or SC1.0.1 FORTRAN in 
it; otherwise, the installation script will not allow you to install the patch. 


The patch installation requires 3.8MB in /usr/tmp and 3.8MB in /tmp. Do 
the following to install the patch: 


1. Become root and extract the patch directory by typing the following on 
a command line: 


/usr/etc/extract_patch -DEFAULT -pfortran_scl_0 


This script will extract the patches from the CD-ROM and place them into 
/tmp/fortran_scl_0. 


2. Change to the directory just created: 


# cd /tmp/fortran.scl0 = ~~ 


3. Copy the filesin /tmp/fortran_sc1_0 to <langdir>/SC1.0, where 
<langdir> is the location you installed the FORTRAN compiler (default is 
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Pascal 2.1 Patch Installation 


FORTRAN, C, Pascal, 
Modula-2: Missing Debugging 
Libraries 


/usr/lang). 


4. Replace the libraries in SC1.0 or SC1.0.1 with those in 
/tmp/fortran_sc1_0 


5. Execute ranlib -t onallofthe .aand .sa files copied. 


Install the Pascal patch in the directory where Pascal is installed; 
/usr/lang/SC1.0 or /usr/lang/SC1.0.1 is the default location. You 
may also specify a non-default directory as the installation directory. Just make 
sure it exists and that you have already installed SC1.0 or SC1.0.1 Pascal in it; 
otherwise, the installation script will not allow you to install the patch. 


Do the following to install the patch: 


1. Become root and extract the patch directory by typing the following on 
a command line: 


7 usr/etc/extract_patch -DEFAULT 


This script will extract the patches from the CD-ROM and place them into 
/tmp/pascal_scl_0. 


2. Change to the directory just created: 


ed /tmp/pascal_sc1_0 : 


3. Copy the files lipbc.so.2.2.1and lipbc.sa.2.2.1 to 
<langdir>/SC1.0, where <langdir> is the location you installed the Pascal 
compiler (default /usr/lang). 


4. Run ranlib: 


-ranlib -t <langdir>/SC1.0/lipbe.sa.2.2.1 


If you are trying to debug or profile with C, FORTRAN , Pascal, or Modula-2, you 
may get an error message indicating that a particular function is missing. This 
may be missing profiling or debug libraries. 


For example, if the profiling libraries are not loaded, you will get a message as 
shown below. 


% £77 -p test.f 
test.f: 
MAIN bork: 


1d: -lc_p: No such file or directory 
S 


Ask your system administrator to help you install the missing libraries. 
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FORTRAN 1.2 Problems 


7.16. Type-4 Keyboard 
Compatibility with 
Unbundled Products 
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The installation of FORTRAN 1.2 may fail on SunOS release 4.1.2. This problem 
is fixed in FORTRAN 1.4. 


To fix this problem, modify the /usr/tmp/1.2_fortran file and restart the 
installation as indicated below. 


1. Stay logged in as superuser. 


2. Change directory to /usr/tmp 


cd /usr/tmp 


3. In any editor, revise the /usr/tmp/1.2_fortran file as follows: 


Change: SOS_COMPAT="4.0" 
to: SOS COMPATS "4. 1,2) 40144 4,0" 


and save the file. 


4. Issue the following command: 


% /usr/tmp/unbundled/1.2_fortran -rrmt_host -ddev 


Where rmt_host is the name of the remote host if the tape is mounted 
remotely, and dev is the device specification (st 0, mt1, etc.). 


5. Restart the installation. 


% install unbundled -f 


Some unbundled software products make full use of native-language keyboards, 
while others will add national language support in future releases. The following 
lists show the status of major software products at the current time. 


Initial testing indicates that the following products provide full national language 
support when used with native language keyboards. Note that in most compilers, 
extended characters may not be used in variable names. 


FORTRAN 1.2 Pascal 2.0 Modula-2 2.1 

C 1.0 C++ 2.0 X Compilers 3.0 
DeskSet 1.0 SunGKS 3.0 SunPHIGS 1.1 
IR 6.0 HSI 6.0 DDN 6.0 

MCP 6.0 FDDI 1.0+ NSE 1.2+ 


SunNet Manager 1.0 SunNet License 1.0 Transcript 2.1.1 


+Not supported in SunOS release 4.1.2. 


S Uu n Revision A of December 1991 


microsystems 


7-16 SunOS 4.1.2 Release Manual 


The following products will correctly recognize any of the national keyboards, 
but will not handle 8-bit characters. Behavior when an accented character is 
typed is unpredictable; some will produce graphics characters and some will 
ignore the keystroke. 


SunWritet/Paint/Draw 1.1 SunTrac 1.3 BSC3270 6.1 


BSCRJE 6.0 CG3270 6.0 SNA Peer 6.0 

Local 3270 6.1 Channel 7.0} SNA3270 6.1 

X.25 6.0 OSI 6.0 MHS 6.0 

SunCobol 1.0 SCLisp 3.0 NetISAM 1.0.DE 
NeWS 1.1 on Type—4 When NeWS 1.1 was released, Type—4 keyboards did not exist. In order to use 
Keyboards NeWS 1.1 with a Type—-4 keyboard, the following patch is required. The patch 


causes NeWS to treat a Type-4 keyboard as a Type—3. 


SNEWSHOME/1ib/NeWS/UI.ps. 


The patch is as follows (context "diff" file): 
cd SNEWSHOME/1ib/NeWS 
eee UT pss Wed Jan 18 11:49:15 1989 
wes US Tue Mar 7 12:27:00 1989 
KKEKKKAEKKKKKK KEE 
K*k* 174,179 wkkKKkK 
--- 174,180 --~-- 
/KB_VT100 
/KB_SUN2 
/KB_SUN3 
+ /KB_SUN4 
/KB_ASCII 


/TR_NONE 
KEKE KEKKEKKKKKKEEK 
kKkK* 699,704 kKaeKK 
--- 700,708 ---- 
(NeWS/sunl_keys.ps) run 
} 
KB_SUN3 { 
(NeWS/sun3_keys.ps) run 
: 
+ KB_SUN4 { 
+ (NeWS/sun3_keys.ps) run 
+ } . 
/Default { 
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8.1. About Kernel 
Configuration 


System Configuration 


This chapter explains and outlines some things you can do to improve system 
performance on Desktop and server systems; the chapter is comprised of the fol- 
lowing sections: 


e About Kernel Configuration 

e Performance Improvement Hints 

e Device Configuration on Open Boot PROM Systems 

e Customizing the Kernel for a Large Server 

e Disk Layout for Systems with 104MB Disks 

e Booting from IPI Disks on SPARCsystem 600MP Systems 


Why would you want to reconfigure and rebuild your kernel? To save main 
memory (and improve performance) by specifying precisely what is needed for 
the applications used, and to add any required drivers and modules. 


When you install SunOS 4.1.X, you use the large GENERIC kernel by default. 
The GENERIC kernel supports all Sun hardware and software features, including 
many that are probably not necessary for your system. Customizing it or using an 
alternative kernel can significantly reduce memory requirements and improve 
performance. It is highly recommended that you reconfigure the GENERIC ker- 
nel as soon as possible after installation. Kernel configuration options are briefly 
described below. For detailed information, see System and Network Administra- 
tion. 


There are three basic alternatives to the GENERIC kernel configuration file: 


e Install one of the Sun-supplied preconfigured GENERIC_SMALL kernel 
configuration files as is. This is the simplest alternative, but is likely to save 
less memory than the others. 


You can install aGENERIC_SMALL kernel with the 
install_small_kernel script, which can be run from the miniroot or 
from a shell as superuser. Standalone systems can use the script to install 
their own kernels; servers can use it to install small kernels for their clients. 


e Build a custom kernel using one of the Sun-supplied kernel configuration 
files as a template. 
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Sun-Supplied Kernel 
Configuration Files 


Table 8-1 


GENERIC_SMALL 
DL60 
NFS60 


DLS60 


SDST60 


Configuration File Name | Supported Architecture 


Desktop SPARCsystem with up to 8 SCSI Disks, 4 SCSI Tapes, 2 CD-ROM 
Diskless Desktop SPARCsystem (Does not support SCSI Devices) 
Desktop SPARCsystem with up to 8 SCSI Disks, 4 SCSI Tapes, 2 CD-ROM 
Configured to Boot from NFS Filesystems 

Desktop SPARCsystem with one SCSI Disk, Configured to Boot from Network, 
but Use Local Swap 

Desktop SPARCsystem with up to 8 SCSI Disks, 2 SCSI Tapes, 2 CD-ROM 


S 
@ 


e Build acompletely customized kernel by editing the GENERIC 
configuration file yourself. This is the most complex of the three alterna- 
tives, but may improve performance the most. 


Kernel configuration files are templates that make it easier to customize your 
system’s kernel. The kernel configuration files for a standalone system or the 
kernel architecture of a server are located in: 


/usr/kvm/sys/k-arch/conf 
— k-arch is replaced by a kernel architecture: sun4, sun4c, sun4m 
The kernel configuration files for the clients of a server are in: 
/export/exec/kvm/k-arch/sys/k-arch/conf 
— k-arch is replaced by kernel architecture (sun3, sun3x, sun4, sun4c, 


sun4m) 


The tables that follow list the kernel configuration files supplied for each of the 
SPARC kernel architectures. These are in addition to the GENERIC configuration 
files, of course. 


Sun-Supplied Kernel Configuration Files for sun4c Architectures 
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Table 8-2 


GENERIC_SMALL 
DL 
DL110 
DL330 
SDST110 
SDST330 
XDXT260 


XYXT260 


IDST390 
IDST490 
SDST470 


Table 8-3 


GENERIC_SMALL 
DL 

NFS 

SDST 

IDST 


8.2. Device Configuration 
on Open Boot PROM 
Systems 


Sy 
& 


Configuration File Name {| Supported Architecture 


Sun-4/110 or 4/330 with up to 4 SCSI Disks and 2 SCSI Tapes 
Diskless Sun-4/260, 4/280, 4/110, or 4/330 

Diskless Sun-4/110 

Diskless Sun-4/330 

Sun-4/110 with up to 4 ScsI Disks and 2 SCSI Tapes 
Desktop SPARCsystem with up to 4 SCSI Disks and 2 SCSI Tapes 

Sun-4/260 with up to 2 SMD-4 Controllers, 2 Xylogics 1/2" Tape Drives, 2 SCSI 
Disks, and 1 SCSI Tape 

Sun-4/260 with up to 2 Xylogics 540/451 Controllers, 2 Xylogics 1/2" Tape 
Drives, 2 SCSI Disks, and 1 SCSI tape 

Sun-4/390 with 2 IPI Controllers with 8 drives each and 4-SCSI tape devices 
Sun-4/490 with 4 IPI Controllers with 8 drives each and 8 SCSI tape devices 
Sun-4/470 with up to 4 SCSI or IPI Controllers, with maximum of 8 drives 
across controllers, 8 SCSI tape devices 


Configuration File Name Supported Architecture 


Sun-4m with up to four users 
Diskless SPARCsystem 600MP 
Sun-4m with SCsI disks and tape; boot from server 
Standalone Sun-4m with SCSI disks and tape 
Sun-4m with IPI disks and SCSI tape 


Sun-Supplied Kernel Configuration Files for sun4 Architectures 


Sun-Supplied Kernel Configuration Files for sun4m Architecture 


The process of rebuilding the kernel of an open boot PROM system (sun4c, 
sun4m) is much simpler than for other Sun systems running SunOS 4.1.2. The 
PROM monitor for open boot PROM, in conjunction with the kernel, eliminates the 
need for most of the device-specification lines in kernel configuration files. 


Standard SunOS kernel configuration files contain many lines describing bus 
connections, controller addresses and slave units on controllers. An open boot 
PROM kernel uses simple declarations for describing devices. For example, in the 
sun4c GENERIC configuration file, the following lines are all that is necessary to 
specify the inclusion of device drivers and kernel support for them; the PROM and 
the kernel auto-configuration code do the rest. 
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‘driver’ for SBus interface 

monochrome frame buffer 

8 bit color frame buffer 

8 bit accelerated color frame buffer 
‘driver’ for dma engine on SBus interface 
Emulex SCSI interface 

Floppy disk 

sound chip 

Lance ethernet 

UARTS 


device-driver 
device-driver 
device-driver 
device-driver 
device-driver 
device-driver 
device-driver 
device-driver 
device-driver 
device-driver 


# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


The flags word that was formerly used to specify ignoring CARRIER DETECT 
for the zs (uaART) driver has been replaced by data in the EEPROM, which the ker- 
nel auto-configuration code asks the PROM to fetch. The fields (ttya- 
ignore-cd and ttyb-ignore-cd) may be set either using either the 
eeprom(8S) command, or commands from the PROM monitor (see 


monitor(8S)). 
Declaring SCSI Buses, Disks, The kernel configuration file also declares the SCSI buses, disks, and tapes that 
and Tapes may be connected to the system. This must be user-entered, rather than deter- 


mined by auto-configuration, because Sun supports some non-CCS (Command 
Command Set) devices which do not respond to the SCSI INQUIRY command 
(which would normally determine what kind of a device it is). 


Two steps are involved. The existence of one or two SCSI buses connected to 
the system must be declared, and disks and tapes must be identified and associ- 
ated with their bus. 


The following screen shows the entries for declaring a first (scsibus0) and 
second (scsibus1) SCSI bus: 


scsibusO at esp 


scsibusl at esp 


The disks and tapes associated with a SCSI bus are declared as shown in the fol- 
lowing example. The example gives GENERIC kernel configuration file default 
declarations for the first SCSI bus. 


scsibus0O target first hard SCSI disk 
scsibus0O target second hard SCSI disk 
scsibus0O target third hard SCSI disk 
scsibus0O target fourth hard SCSI disk 


scsibus0O target first SCSI tape 
scsibus0 target second SCSI tape 
scsibusO target CD-ROM 
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To be more specific, the first line above says that there may be a disk, sd0, on 
scsibus number 0, at SCSI target address 3, logical unit 0. These declarations 
merely state that this device may be at this location; look for it when booting, and 
(if not found) look again if a program attempts to open it while the system is run- 
ning. 


The default declarations in the GENERIC kernel configuration file for disks and 
tapes on a second SCSI bus are: 


scsibusl target fifth hard SCSI disk 
scsibusl target sixth hard SCSI disk 
scsibusl target seventh hard SCSI disk 
scsibusl target eighth hard SCSI disk 


scsibusl target third SCSI tape 
scsibusl target fourth SCSI tape 
scsibusl target second CD-ROM device 


The default declarations for a third and fourth SCSI bus can be found in the 
GENERIC kernel configuration file for your Sun-4c or Sun-4m system: 


/usr/sys/sun4c/conf/GENERIC 
/usr/sys/sun4m/conf/GENERIC 


Booting from IPI Disks on If you intend to boot or reboot a 4.1.2 based Sun-4m system from an IPI disk 
SPARCsystem 600MP device, you must make sure that certain "pseudo" device drivers are included in 
Systems the kernel configuration file, in addition to the standard ipi, is, idc, id, and 


ipibus configuration information that is required to include device driver sup- 
port for the IPI disk devices. 


The additional pn, ipisc, and idpseudo devices, which are included in the 
standard Sun-4m GENERIC configuration file, interract with the open boot PROM 
at boot and reboot time to obtain and provide self-identifying information. The 
following entries must be in the kernel configuration file: 


device-driver pn # Self-ident. VME/IPI pseudo driver 


device-driver ipisc # Self-ident. IPI-3 Slave Cntrl pseudo driver 


device-driver idpseudo # IPI Disk pseudo device driver 


If you are not using the GENERIC kernel, or if you have removed the above lines 
from the GENERIC kernel, be sure to include the lines in the kernel configuration 
file before making a new kernel. 
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8.3. Customizing the 
Kernel for a Large 
Server 


Maximum maxusers Values 
for Sun-4, Sun-4c, Sun-4m 
Servers 


Table 8-4 


Formula for Determining 
maxusers 


On large servers it may be necessary to adjust two basic parameters in the kernel 
configuration file: 


e maxuSers 


e number of ports (for systems with ALM-2’s) 


For best performance, you want to set the maxusers value in the kernel 
configuration file to a high value. Use the formula described below to determine 
the maxusers value, but be aware of the following limitations; if you exceed 
these values, your kernel may not boot. 


Maximum maxusers Values for Sun-4, Sun-4c, Sun-4m 


64MB RAM or less| 128MB RAM | 640MB RAM |2.5GB RAM 


Note that the maximum maxusers value for a SPARCsystem 600MP system is 
between 45 and 185, depending on the system configuration — the more 
memory, the lower the maxusers value. These maxusers values correspond 
to 1024 and 3253 processes, respectively. 


The GENERIC kernel configuration file in the directory /usr/kvm/sys/k- 
arch/conéf sets a default value for maxusers that is too small for large 
servers, and is more suitable for personal—use workstations. Check the file for 
the line 


maxusers maxusers_value 


and, if necessary, increase maxusers_value to reflect the actual load on the server. 
The number of streams allocated is based on this number, so for proper alloca- 
tion, any get ty’s running on serial ports should be considered active sessions, 
and if any lines are running both dial-in and dial-out service via the upper 128 
minor numbers, the dial-out should be considered an additional user. 


The calculation of maxusers is generally: 
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number of framebuffer sessions (i.e., windows and other tools, 
or one for a nonwindow login on the console), 


plus 


number of network sessions (telnet, ftp, rsh, and 
r login sessions to or from this host) 


plus 
number of serial ports with get ty’s running on them, 
plus 


maximum number of concurrent dialout (t ip and uucp) 
sessions. 


Then add a few, and round the figure upward, because you will probably underes- 
timate, and the cost of the extra kernel size is not much when you have large 
memories (32 MB and up) and disks (600 MB and up). In general, systems with 
eight ALM-2 boards will also tend to have larger physical memories and larger, 
faster disks, so setting maxusers on the high side is usually preferable to setting it 
too low. See limits on maxusers size in the table above, however. 


In the kernel configuration file, the line 


pseudo-device mcpa64 


needs to be adjusted to include all ALM-2 serial ports that are likely to be used 
(if you have no ALM-2’s, you can delete the line or comment it out). For any 
kernel that is expected to support any of the upper four ALM-2 boards (mcp4 
through mcp7), this line should be changed to 


pseudo-device mcpal28 


to provide async protocol support for the whole set. Note that if you use a higher 
numbered ALM, then the mcpa number must be great enough to handle that 
ALM and all lower numbered boards, installed or not. 


When adding ALM-2’s, you must create the /dev entries, as follows: 


# cd /dev : 
# MAKEDEV mcp0O mcpl mcp2 ... 


where an mcpn entry is specified for each ALM-2, up to a max of mcp7. The 
/ dev entries created by this command are the names which must be entered into 
/etc/ttytab. 
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Make Entries in You will have to manually make entries in the /etc/ttytab file. See the 
/ete/ttytab System & Network Administration manual, Section 11.3, “Adding a Terminal to 
your System.” 


The procedure for adding tty ports: 

1. Determine the total number of logins to be supported. 

2. Apply the algorithm described above for computing maxusers. 
3. Rebuild the kernel, if required. 

4. Make entries in /dev for the new tty ports. 


Do this with /dev/MAKEDEV. Each argument to MAKEDEV represents one 
peripheral board, e.g., “MAKEDEV mcp0O” means make all tty port entries 
(16) for the first ALM-2, “MAKEDEV mcp7” means make all tty port 
entries (16) for the 8th ALM-2 board. 


5. Make entries in /etc/ttytab for each tty port. The format is shown in 
System & Network Administration, section 11.3. 


Sample /etc/ttytab entries: 


"/usr/etc/getty .9600" unknown secure 
"/usr/etc/getty .9600" unknown secure 
"/usr/etc/getty 29600" unknown secure 
"/usr/etc/getty -9600" unknown secure 
"/usr/etc/getty .9600" unknown secure 
"/usr/etc/getty 9600" unknown secure 
"/usr/etc/getty +9600" unknown secure 
"/usr/etc/getty -9600" unknown secure 
"/usr/etc/getty ¥9600" unknown secure 
"/usr/etc/getty ~9600" unknown secure 
"/ausr/etc/getty »9600" unknown secure 
"/usr/etc/getty .9600" unknown secure 
"/usr/etc/getty ~ 9600" unknown secure 
"/usr/etc/getty .9600" unknown secure 
"/usr/etc/getty O600" unknown secure 
"/usr/etc/getty -9600" unknown secure 
"/usr/etc/getty .9600" unknown secure 


Possible Error Messages If too many /etc/ttytab terminals are enabled, or too many remote logins 
occur, compared to the maxusers setting inthe config file, the message 


stropen: out of streams 


may be displayed on the console and in the /usr/adm/messages log. This is 
an indication that you should increase the maxusers value, and re-build the 
kernel. 


After configuring, building, and booting the new kernel, start up the system and 
run it for a while. Any messages relating to exhaustion of streams resources are a 
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red flag that you may need to refigure the correct value for maxusers. 


Monitor long term performance with netstat -m, and reduce resource allo- 
cations if it is shown that peak allocations never get near the allocated maxima. 
You will want to do this re-allocation of resources if the performance of the 
machine is suffering due to lots of memory being hogged by the kernel — espe- 
cially if the cost of reconfiguring the kernel is low (low impact on users). 


Bear in mind that allocation of data buffer resources may start to fail when the 
high water mark reaches 80% of the configured maximum, as the system tries to 
reserve some resources for high priority messages. No matter how careful you 
are to watch the resources, you always need some extra room, so don’t tune your 
system too tightly; tune it so that the observed maximum numbers are between 
50% and 75% of the absolute limit values in your kernel configuration file. 


Consider the following ideas for improving performance. 


The tmpfs filesystem allows a system’s virtual memory resources to be used as 
a filesystem. Files and directories can be created and deleted with normal UNIX 
semantics. The tmpfs filesystem does not require additional disk space and 
allows data to be accessed quickly. tmpfs-mounted directories appear identical 
to standard UNIX filesystems to users and most UNIX utilities. 


For details on using the tmpfs filesystem, see the System and Network Adminis- 
tration manual and the tmpfs(4S) man page. 


The tmpfs filesystem is commonly used to improve the performance of the 
/tmp directory. However, note that unmounting /tmpfs or rebooting your sys- 
tem removes all files under /tmpfs, including those in subdirectories. 


Workstations that have only one Ethernet interface and do not act as NFS servers 
can do static routing, rather than dynamic routing with in. routed. 


To institute static routing, “comment out” (place a “#” in front of) lines in your 
/etc/rc.local file so that they appear as shown: 


#if [ -f£ /usr/etc/in.routed ]; then 
# in.routed: echo. n°’ routed” 


#f£1 


Routing table entries will still be added or modified by the kernel as a result of 
ICMP redirect messages. 


Diskless clients have a route provided automatically by the server. On other 
workstations, a command of this form can be added to rc. local just after the 
in. routed information: 
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Do Not Enable Process 
Accounting 


Eliminate Unnecessary Server 
Processes 


Do Not Enable File-System 
Quotas 


8.5. Disk Layout for 
Systems with 104MB 
Disks 


Desktop SPARCsystem with 
Two 104MB Disks: Using 
Second Disk for /home and 
Additional Swap Space 


SY 


/usr/etc/route add default router 1 


This action frees up both the pages used by in. routed and most of the 
memory allocated for routing table entries. 


Accounting is not enabled unless it is configured into the kernel (options 
SYSACCT) or there is a /var/adm/acct directory when your system boots. 
See the man page for rc(8) for more information. 


Workstations typically only require the following server processes: 
e® portmap 
e ypbind 


e biod (four processes) 


e syslogd 
e update 
e inetd 

e lpd 


e sendmail 
e keyserv (if you use secure NFS) 


Eliminating any additional server processes will increase performance. 


Initially, the default is for file-system quotas not to be enabled. If quotas have 
been enabled, replace /usr/ucb/ quota with /usr/bin/true. This will 
prevent possible delays at login time due to calls to rpc . rquotad on each 
NFS server from which you have a file system mounted. 


Two procedures are described in this section: 


e Desktop SPARCsystem with Two 104MB Disks: Using Second Disk for 
/home and Additional Swap Space 


e Desktop SPARCsystem with Two 104MB Disks: Using Second Disk for 
OpenWindows 


This section describes how to set up a /home filesystem on the g partition of 
your second disk and how to use your second disk for added swap space. Note 
that you cannot use sd1g for both /home, as described here, and for OpenWin- 
dows, as described in section 8.5.4 below; you must choose between one use or 
the other. 
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A Desktop SPARCsystem with preinstalled SunOS 4.1.2 on a 104 megabyte disk 
does not have a separate /home filesystem for local text and data files. “home” 
files are maintained in subdirectories of the /usr filesystem, which they share 
with unbundled and third-party application software. What may appear online as 
a separate /home filesystem is really a “symbolic link” to files in 
/usr/export/home. 


If you use space on a second disk as a /home filesystem, more space is available 
for application software on the first disk and for local user files on the second 
disk. 


You may need to use your second disk to provide extra swap space; consider this 
if you start getting the following error message: 


Not Enough Memory 


when you start up a program. In many cases, additional swap space improves 
system performance, even without an initial shortage. 


Using the g Partition on Your To use the g partition of your second disk as /home: 


Second Disk as /h ls 
il 1. Asa precaution, if there are files in /usr/export /home on your first 


disk, use dump(8) to make backup copies. 


2. Become superuser and create a new filesystem in partition g on your second 
disk: 


$su 


#newfs /dev/redig 


3. Create an entry in your /etc/fstab file so that the new filesystem is 
automatically mounted as /home when you boot your system: 


#/dev/sdlg /home 4.2 rw 1 3 


4. If you have user accounts and files in /usr/export /home, transfer them 
to the g partition of your second disk: 


#mount /dev/sdig /mnt 


#ed /usr/export/home; tar cfh - . | (cd /mnt; tar xpf -) 


5. List the files copied to the new filesystem to make sure the transfer took 
place correctly: 


#ls -1R /mnt 


6. If the files were copied to /mnt as desired, you can now remove them from 
/usr/export/home, freeing the space they occupied for other software: 
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Using Your Second Disk for 
Added Swap Space 


Desktop SPARCsystem with 
Two 104MB Disks: Using 
Second Disk for 
OpenWindows 


ten -rf /usr/export/home/* : : / _ o _ a . : 


7. Remove /home as a link to /usr/home and create anew /home direc- 
tory as a mount point for the /home filesystem on the second disk: 


#rm /home 


#mkdir /home 


8. Mount the /home filesystem on your second disk on the /home directory 
of your first disk: 


#mount /home 


The procedure given above is an easy way to set up a home filesystem on your 
second disk. It is possible to move other filesystems to your second disk, to 
change the sizes of the given partitions, and to use partitions other than g for 
/home. For further information on this, see System and Network Administration 
and Installing SunOS System Software. 


To use the b partition of your second disk for additional swap space: 


1. Become superuser and create an entry in your /etc/ fstab file so that 
whenever you boot, the b partition of your second disk is automatically 
mounted for use as swap space in addition to the swap space on your first 
disk. The entry for your fstab file is: 


/dev/sdib swap swap rw 0 0 


2. To turn swapping from your second disk on, su to root and type: 


#swapon -a 


On your second disk, you can use partitions other than b for swap space. To do 
so, replace sd1b in the preceding steps with sd1 and the name of the partition 
you want to use for swap. 


If you use the first 104MB disk of a Desktop SPARCsystem as the system disk 
for SunOS 4.1.2 release software, there will not be enough room for OpenWin- 
dows. This section describes how to use the g partition of your second disk 
(sd1g) for OpenWindows. 


If you put OpenWindows in sdi1g, you will have about 21MB of space in /usr 
on your first disk for use by /home. 
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Experienced users who want to have more options in using their second disk 
should refer to the System and Network Administration manual, which provides 
detailed information on disk partitioning, mounting partitions, and using sym- 
bolic links. 


Note that you cannot use sd1g for both /home, as described above, and for 
OpenWindows, as described below; you must choose between one use or the 
other. 


The procedures you need to follow in using sd1g for OpenWindows depend on 
whether or not you use SunInstall to install SunOS 4.1.2 release software. 


If you use SunInstall, you can set up a /usr/openwin filesystem in sd1lg 
from the start; see Installing SunOS System Software for instructions on setting 
up file systems on a second disk. After using SunInstall you can load OpenWin- 
dows in sd1g by following the instructions given in the section “Installing the 
OpenWindows Software in sd1g,” below.* 


If you have the preinstalled version of SunOS 4.1.2 on your first disk or you use 

re-preinstall or Quick Install, you will need to create a /usr/openwin filesys- 
tem in sdig and carry out additional steps before your can load OpenWindows 

into sdlg. 


To use the g partition of your second disk for OpenWindows: 


1. Become superuser (you will need to be superuser for the remaining steps) 
and create a new filesystem in sd1g. This will be your OpenWindows 
filesystem. 


Note: Sample display; contents may vary, depending on user input and the system used. 


2. Use fsck to check the new filesystem: 


* Do not try to load OpenWindows into sd1g with SunInstall. SunInstall will balk, with the message that there 
is insufficient space. 
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3. Transfer the contents of /usr/openwin on your first disk to your new 
filesystem in sdlg. These contents, subdirectories and symbolic links for 
use by OpenWindows, were preinstalled or set up when you used Quick 
Install or re- preinstall. 


4. Make sure the transfer was carried out correctly; compare the contents of 
/usr/openwin and sdlg: 


5. Ifthe contents matched, remove the contents of /usr/openwin from 
/usr on your first disk: 


6. Edit your /etc/fstab file so that your OpenWindows filesystem on 
sd1g is automatically mounted as /usr/openwin whenever you boot 
your system. Edit /etc/ fstab and add the line: 


/dev/sdlg /usr/openwin 4.2 rw l 2 


7. Mount sdig on /usr/openwin: 
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You are now ready to load the OpenWindows software. The remaining steps are 
the same as those for systems that defined the /usr/openwin partition using 
SunInstall. 


To install OpenWindows in the filesystem you created in sd1g, change direc- 
tories to /usr and use the new ext ract_files(8) command to load the 
OpenWindows software categories from your SunOS 4.1.1 release media.* You 
must be superuser to use ext ract_files. 


Note that you do not need to load OpenWindows_Programmers unless you 
plan to develop window-based applications that will run in an OpenWindows 
environment. 


* In addition to the man page for ext ract_files, see Chapter 2 for information on using 
extract_files. 
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Part 4 — Open Issues 


Part 4, which is found in a package on top of the release binder in the Release 
Minibox, is comprised of two important chapters: 


e Late-Breaking News 
e Known Problems 


Be sure to insert the Open Issues package (Part Number 800-6643-10) into the 
binder and to read the two chapters before proceeding with the installation of 
SunOS 4.1.2. 


Part 4 — Open Issues — Continued 
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SunOS 4.1.2 Open Issues 


This package contains important information for the SunOS 4.1.2 Release Manual. Insert the attached 
material in the Release binder, behind the Open Issues tab. 
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Part 4 — Open Issues 


Part 4, which is found in a package on top of the release binder in the Release 
Minibox, is comprised of two important chapters: 


e Late-Breaking News 


This chapter includes warnings about patch installations, lists of additional 
bug fixes and patches, documentation changes, and ergonomics compliance 
standards for German installations. 


e Known Problems 


This chapter includes lists and descriptions of bugs in SunOS and OpenWin- 
dows Versions 2 and 3. 


Be sure to insert this Open Issues package into the binder behind the tab for Part 
4 and to read the two chapters before proceeding with the installation of SunOS 
4.1.2. 


Part 4 — Open Issues — Continued 
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Late-Breaking News 


This chapter provides the latest news about the FCS version of SunOS 4.1.2, 
dated December 1991. This chapter includes the following sections: 


e Warnings about Patch Installations 

e Additional Bugs Fixed and Patches Added 

e Additional CTE Escalations Fixed in SunOS 4.1.2 

e Release Manual Documentation Changes and Additions 
e Sunupgrade Workarounds and Documentation Changes 
e Ergonomics Compliance (Germany) 

e Ergonomievorschriften (German-language version) 


If you are going to use sunupgrade to upgrade to SunOS 4.1.2, be sure to read 
Section 9.5 before starting the upgrade. 


See Chapter 10 for listings and descriptions of known problems with the release. 


Do not install a patch unless you are sure the patch is compatible with the 
currently-installed release. 


This patch has been incorporated in the OpenWindows Version 2 included with 
SunOS 4.1.2; the patch is unnecessary and may cause system problems if it is 
installed on top of SunOS 4.1.2. Do not install it. 


A special patch was provided for Sun-4 systems running SunOS 4.1.1 and Sun-4c 
systems running SunOS 4.1.1 Rev B, to enable use of the 1.3GB disk on these 
systems. The changes have been incorporated in SunOS 4.1.2; the patch is 
unnecessary. Do not install it. 
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9.2. Additional Bugs Fixed 
and Patches Added 


Kernel Bugs Fixed 


Network Bugs Fixed 


Linker-loader Bugs Fixed 


Graphics Bugs Fixed 


Library 


New Patches Available (Bugs 
1074337, 1073234) 


9,3. Additional CTE 
Escalations Fixed in 
SunOS 4.1.2 


dw sun 


The following bugs were fixed and CTE patches added since the SunOS 4.1.2 
Release Manual went to press. 


1047696: Panic when trying to install software on Sun-4c with 40MB or more of 
memory; hat_pmgreserve error. 


1068363: SPARC 2 system crashes with maxusers greater than 83. 


1065361: Wrong gid for existing file created again. 
1045211/1042491: Some network services invoked by inetd may fail to run. 


1070559: 1d.so exhausts swap space with some shared libraries. 


1071121: GT crashes when picking PHIGS solids with front face culling 
enabled. 


1052558: System call should do a vfork, not a fork. 


Patches are available for the following bugs through your local Sun Answer 
Center if your system is under warranty or if you have a support contract: 


e Bug: 1074337: When formatting disks on Sun-4s, if the defect list happens 
to be large enough to require two disk blocks, you may get a format failure: 


formatting... done 


assertion failed: file ’ctlr_ sesi.c’, line 2331 


See the description of the bug in Section 10.2 for more detail. 


e Bug: 1073234: mmap system call fails on Sun-4m for data fetch of nonex- 
istent device memory address. See the description of the bug in Section 10.2 
for more detail. 


In addition to the Corporate Technical Escalation (CTE) patches listed in Section 
6.13 of the Release Manual, the following CTEs were also fixed in SunOS 4.1.2. 
The patch ID 1s followed by a list of the bugs fixed by the patch, with brief 
descriptions. 


Patch 100244-02 [roll from 100244-01] 
1033287 Frequent exhaustion of chanmap resource observed 


Patch 100356-01 [new] 
1067615 Kernel hangs while processing aiocancel system call. 
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Changes and Additions 


Open Windows Version 2 CTE 
Patches: Bugs Not Fixed in 
SunOS 4.1.2 


Corrections to List of CTE 
Patches Fixed in SunOS 4.1.2 


Location of New Commands 
mps and mpstat 
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Patch 100364-01 [new] 
1029802 4/280 with xy451 panics: registerss accessed while busy. 


Patch 100346-01 [new] 
1044722 Undefined symbol in libxpg.a. 


Patch 100357-01 [new] 
1066663 SIGIO signal for async IO fails to pend across NFS. 


Patch 100173-06 {roll from 100173-04] 
1066287 NFS hang when looking at large file being changed on server. 
1064433 Export of subtree doesn’t work 
1045536 NFS exports to non-Sun system can result in file truncation. 


Patch 100305-06 
1063772 Possible to overwrite any file on system using lpr. 
1058003 Reading from /dev/printer, lpd doesn’t check how much data 
it has read 
1016437 1pd does not check file names for legality. 
1040453 1pd can be used by any user to delete any file on the system. 


The CTE OpenWindows Version 2 patches listed in Section 6.14 of the Release 
Manual are available through your local Sun Answer Center if your system is 
under warranty or if you have a support contract; the bugs corresponding to these 
patches were not fixed in SunOS 4.1.2. 


Patch ID 100173 is incorporated at the -06 level — not the -03 level; it is listed at 
both levels. 

Patch ID 100174 is incorporated at the -03 level — not the -01 level. 

Patch ID 100199 is incorporated at the -02 level — not the -01 level. 

The new SPARCsystem 600MP commands, mps and mpstat, described in 


Chapter 2 of the Release Manual, are only available for MP systems; they are 
found in /usr/kvm. 
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9.5. Sunupgrade 
Workarounds and 
Documentation 
Changes 


Change Time Zone Before 
Running check_perm 


File /etc/uucp/Systems 
Is Replaced 


If You Have XNews Server 
Patch 
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Unless you are in the US/Pacific time zone, you should set the time zone to 
US/Pacific before running check_perm; if you don’t, SunOS 4.1.1 files that 
you have not changed since installation will be flagged as changed and included 
in/usr/tmp/volatile file. Ifyou then use 
/usr/tmp/volatile file as your volatile file list, all those files will be 
saved with .411 tags. 


A simple workaround for this problem is to execute one of the following com- 
mands, depending on whether you are running the C shell or Bourne shell. Since 
you run the commands in a sub-shell, your time zone will not be permanently 
reset. 


csh example: 


Note that the file /etc/uucp/Systems is replaced during sunupgrade. If 
you wish to preserve your current version of the file, you will have to copy or 
move it before running sunupgrade, or you could add 
/etc/uucp/Systems to your own volatile file list and use it instead of the 
default list, volatile list. 


Alternatively, if you run check_perm, the file will be included in 
/usr/tmp/volatile file, which can then be used when running sunup- 
grade. A backup copy of /etc/uucp/Systems will then be saved, with a 
.411 suffix. 


If you have installed the XNews Server patch (100176-08), you may see the fol- 
lowing message during sunupgrade: 


/usr/openwin/bin/xnews won’t be upgraded because not 


a regular openwindows server 


This patch, which is not included in SunOS 4.1.2, will not be overwritten by 
sunupgrade. The rest of the OpenWindows package will be upgraded. 
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Installation Manual: 
Upgrade; Rebuild Kernel 
Before Reboot 


Installation Manual: 
Upgrade; Multi-user Error 
Message 


Installation Manual: 
Upgrade; Remote Upgrade 
Needs nfsd 
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On page 2-9 (step 15) and 2-13 (step 16) of Installing SunOS 4.1.2 System 
Software the following note should be added to the last sentence of the last para- 
graph of the step: 


“If you customize your kernel configuration file, you will have to rebuild and 
install the new kernel before rebooting.” 


It is assumed that you ran shut down before starting sunupgrade, as 
described in the instructions; sunupgrade checks to see if /etc/utmp is 
empty before starting the upgrade. If it is not empty, an error message indicating 
that you are running in multi-user mode will be displayed and sunupgrade 
will exit. You will have to zero out /etc/utmp or boot multi-user and run 
shutdown before running sunupgrade. 


In step 3 of the instructions for remote upgrades, you are told that you may have 
to start rpc .mountd manually. You may also have to start nfsd. See the 
mountd(8c) and biod(8) man pages for details. 
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9.6. Ergonomics 
Compliance 


German Ergonomics 
Standard 


Using SunView with 16- and 
17-Inch Monitors 


Shelltool Support for 
International Keyboards 


Note that this section is included in both English- and German-language ver- 
sions; the German version follows the English version. 


To comply with the German ZH1/618 ergonomics standard, you must use the 
Graphical User Interface available under SunView. The OPEN LOOK Graphical 
User Interface does not comply with the standard. 


To comply with the ZH1/618 standard, the display character height must be at 
least 2.6 mm. SunView complies with the standard on 19-inch monitors, but you 
must change the SunView default font size on 16- and 17-inch monitors. To 
change the default font size for SunView, complete the following procedure. 


1. Start Sun View. 


2. Start the Defaults Editor program from the SunView menu or from a com- 
mand tool or shell tool by typing: 


3. In the SunView defaults category, change the Font default to: 


/usr/lib/fonts/fixedwidthfonts/screen.r.16 | 


4. Save your edits and quit the Defaults Editor. 
5. Exit and restart SunView. 


The new font size will now be used to display text. 


To use the shelltool (an SunView or OpenWindows) with non-ASCH characters 
generated by non-U.S. keyboards or characters generated with the Compose key 
of any keyboard, you must edit the shell initialization file to enable an 8-bit data 
path. To use the shelltool (in SunView or OpenWindows) with non-ASCII char- 
acters generated by non-U.S. keyboards or characters generated with the Com- 
pose key of any keyboard, you must edit the shell initialization file to enable an 
8-bit data path. 


To enable the non-ASCII characters in a shelltool: 
1. Type env in a command window to determine the shell you are running. 


If SHELL=/bin/csh is displayed, you are running the C shell, so you 
should edit your . cshrc file. 


If SHELL=/bin/sh is displayed, you are running the Bourne shell, so you 
should edit your . profile file. 


2. Edit the shell initialization file. 
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Edit your .cshrc file if you are running the C shell, or edit .profile file 
if you are running the Bourne shell. These files are in your home directory. 
To change to your home directory, type cd and press Return. You can use 
any text editor to edit these files. 


In the .cshrc file, add these two lines at the beginning of the file; 


setenv LC_CTYPE iso_8859 1 


stty pass8 


In the . profile file, add these two lines at the beginning of the file: 


Le “CTYPH=180: 8659.17 export.LC CTYPE 
stty pass8 


Changes to the .cshrc and .profile files will take effect in subsequent 
shelltools; or you can "source" these files in existing shelltools by typing 
source and the name of the file. 


This example enables the non-ASCII characters in a C shell: 
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9.7. Ergonomievorschriften 


Deutsche Ergonomie-Norm 


Verwendung von SunView bei 
16- und 17-Zoll-Monitoren 


Shelltool fur internationale 
Tastaturen 


Um die deutsche Ergonomie-Norm ZH1/618 zu erfillen, mu8 die unter SunView 
bereitgestellte grafische Benutzeroberflache verwendet werden. Die grafische 
Benutzeroberflache OPEN LOOK entspricht dieser Norm nicht. 


Um der Norm ZH1/618 zu entsprechen, muB die Zeichenhohe mindestens 2,6 
mm betragen. SunView erfullt diese Bedingung bei 19-Zoll-Monitoren, jedoch 
muB bei 16- und 17-Zoll- Monitoren die SunView-StandardschriftgroBe erst 
geandert werden. Mit der folgenden Vorgehensweise kann die SunView- 
StandardschriftgroBe angepaBt werden: 


1. Starten Sie SunView. 


2. Wahlen Sie aus dem SunView-Menu das Programm “Defaults Editor’ oder 
geben Sie bei einem Command Tool oder Shelltool folgendes ein: 


3. Andern Sie in der SunView-Standardkategorie die vorgegebene Schriftart 
(“Font”) wie folgt: 


/usr/lib/fonts/fixedwidthfonts/screen.r.16 


4, Speichern Sie die Anderung und beenden Sie den “Defaults Editor”. 
5. Verlassen Sie SunView und starten Sie es neu. 


Fur die Textanzeige wird jetzt die neue Schriftgro6Be verwendet. 


Um das Shelltool (in SunView oder OpenWindows) in Verbindung mit Nicht- 
ASClI-Zeichen, die mit Tastaturen aus anderen Landern als den USA erzeugt wur- 
den, oder Zeichen, die mit der Compose-Taste einer beliebigen Tastatur generiert 
wurden, verwenden zu konnen, muB die Shell-Initialisierungsdatei so editiert 
werden, da8 ein 8-Bit-Datenpfad freigegeben wird. 


Um die Nicht-ASCu-Zeichen in einem Shelitool freizugeben: 


1. Stellen Sie durch Eingabe von env in einem Befehlsfenster fest, welche 
Shell aktiv ist. 


Wenn SHELL=/bin/csh angezeigt wird, handelt es sich um die C-Shell, 
und Sie sollten Ihre . cshrc-Datei editieren. 


Wenn SHELL=/bin/sh angezeigt wird, ist die Bourne-Shell aktiv, und 
Sie sollten Ihre . profile-Datei editieren. 


2. Editieren der Shell-Initialisierungsdatei. 


Editieren Sie Ihre . cshrc-Datei, wenn die C-Shell aktiv ist bzw. Ihre 
. profile-Datei, wenn die Bourne-Shell aktiv ist. Diese Dateien befinden 
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Sich in Ihrem Stammverzeichnis. Um zu Ihrem Stammverzeichnis zu 
gelangen, schreiben Sie cd und driicken Sie die RETURN-Taste. Sie konnen 
diese Dateien mit jedem beliebigen Texteditor editieren. 


Fiigen Sie in der . cshrc-Datei die folgenden zwei Zeilen am Anfang der 
Datei ein: 


setenv LC_CTYPE iso 8859 1 


stty pass8 


Figen Sie in der .profile-Datei die folgenden zwei Zeilen am Anfang 
der Datei ein: 


LC_CTYPE=iso_ 8859 1; export LC_CTYPE 
stty pass8 


Anderungen der . cshrc-Datei bzw. . profile-Datei treten bei nachfol- 
gend aktivierten Shelltools in Kraft. Sie konnen die Anderung der Dateien 
jedoch auch bei bereits aktiven Shelltools wirksam machen, indem Sie 
source und den Namen der Datei eingeben. 


Das folgende Beispiel veranschaulicht das Freigeben der Nicht-ASCI- 
Zeichen in einer C-Shell: 
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10.1. System 
Administration 


Unable to Install Multiple OS 
with SunInstall via Multiple 
CD-ROMs (1042906) 
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Known Problems 


This chapter lists known problems with SunOS 4.1.2. Problems and bugs are 
grouped in the following sections: 


Section 10.1 System Administration 
Section 10.2 Kernel 

Section 10.3 Graphics 

Section 10.4 Network 

Section 10.5 Utilities 

Section 10.6 Compiler 

Section 10.7 Hardware 

Section 10.8 PROM 

Section 10.9 Sundiag 

Section 10.10 Sun 386i 

Section 10.11 Documentation 

Section 10.12 CD-ROM 

Section 10.13 Library 

Section 10.14 Miscellaneous 

Section 10.15 OpenWindows Version 2 
Section 10.16 OpenWindows Version 3 Product Notes 


When available, bug ID numbers are given in parentheses after headings. They 
can be used for referencing problems if you need to contact a Sun Answer Center 
or sales representative. 


SunOS software can only be installed from one CD-ROM during SunInstall. [f 
you want to install 4.1.2 and 4.1.1 or 4.1 on a machine (to provide Sun-3 support, 
for instance), allocate disk space and use add_services to load the other 
release from CD-ROM, or extract the other release from tape, if available. 
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Full Install Option Under 
Quick Install Does Not Create 
/home Partition on 207MB 
Disks (1044999) 


add_services(8) Requires 
350KB in /usr (1032894) 


Automounter May Cover 
/home on System Mounting 
/home from Local Disk 
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If you choose the “Full Install’’ option under Quick Install to load release 
software on a 207MB disk, /home is created as a symbolic link to 
/usr/export/home in order to make optimal use of disk space. 


If you use add_services to adda client to a server of the same application 
architecture, but of a different kernel architecture, the /usr partition must have 
at least 350KB of available space. This applies to clients and servers running 
under the same release; it is not a problem under multiple releases. The require- 
ment results from the fact that the root software category is shared between dif- 
ferent architectures of the same release. The existing code assumes that root 
should go into /usr/share, instead of /export /exec. If no space is avail- 
able in /usr/share, the system sends an error message such as: 


| Not enough space in sd0a | 


If your system is using the automounter and you mount the home partition of 
your local disk on /home, the automounter may cover your /home directory 
and prevent you from accessing it. 


The automounter is enabled on most systems by default and uses automounter 
maps (often these are NIS maps) to find file systems and determine mount points. 
The automounter preempts the directories that it uses as mount points so that 
only the file systems it mounts on them are accessible. In most cases, the user’s 
home file system has been entered on an automounter map, and the automounter 
mounts it on the user’s /home directory. A problem can arise if you maintain 
your home file system on a local disk, your home file system is not included on 
an automounter map, and you mount it on your /home directory. In this case, 
the automounter does not know about your home file system, cannot mount it on 
/home, and prevents you from accessing it. 


In order to have access to your home file system, you have to give it a mount 
point that has not been preempted by the automounter. To do this, you can 
become superuser, create a new directory, and mount your home partition on it, 
as in the following example: 


You can also set up an entry in your /etc/fstab file so that your local home 
file system is automatically mounted whenever your system reboots or you use 
the mount(8) command to invoke your fstab file. (See fst. ab(5) for infor- 
mation on setting up an entry in /etc/fstab.) 


If you have an entry in fstab that mounts your local home file system on 
/home, the automounter will not only prevent you from accessing your file 
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If add_client -i Fails, Use 
xrm_client Before Retrying 
(1033185) 


add_client Does Not Set Up 
Multiple Hostnames for 
Multiple Ethernets (1017238) 


Long Delay before Prompt in 
Remote Install from CD on 
SPARC 390/4X0 System 
(1043209) 
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system, it will prevent you from unmounting it so that you can remount it else- 
where. In this situation, you need to edit your fstab file so that /home is no 
longer a mount point for your home file system. You must then reboot your sys- 
tem; the automounter prevents you from unmounting your local file system from 
/home in any other way. 


If the command add_client —i fails, you must use rm_client to delete 
any clients entered on the failed attempt before using add_client —i to re- 
enter the same clients. 


A server with multiple ethernets will have separate hostnames for each of them. 
The add_client utility only knows the hostname for the first ethernet. As a 
result, diskless clients created on secondary ethernets will only have the host- 
name for the first ethernet and will not be able to boot. To correct this, you must 
manually change the hostname of the first ethernet to the hostname of the client’s 
ethernet in the following files on the server: 


/etc/bootparams 
/export/root/client/etc/fstab 


In addition, SunInstall only enters the hostnames of the first two ethernets on a 
server in a client’s /export/root/client/etc/hosts file. You must manu- 
ally enter the hostnames of any additional ethernets. 


If you are using NIS, you will also need to update the boot params map on the 
NIS server. 


If you install SunOS 4.1.X from a remote CD-ROM on a SPARC 390/4X0 sys- 
tem and boot the miniroot, there is a series of prompts up to: 


root file system type (spec 4.2 nfs): 


After you respond to this prompt there is a delay of up to 90 seconds before the 
next prompt while the system polls possible controllers. The delay is due to the 
increased number of controllers and drives supported under SunOS 4.1.1. 
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10.2. Kernel 


Asynchronous I/O Peaks Can 
Hang System (1073679) 


Disks on esp2, esp3, 
esp4 not seen by miniroot 
(1060701) 


format: Assertion Failure on 
1.3GB Elite Drives on Sun-4 
(1074337) 


mmap System Call Fails on 
Sun-4m for Data Fetch of 
Nonexistent Device Memory 
(1073234) 


Start RFS on Both Primary 
and Secondary Servers If 
Both Are in Domain (1028779) 


Large maxusers Parameter 
May Cause System to Panic 
(1038406) 
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The kernel keeps a cache of stacks for kernel LWPs in memory, and grows this 
cache on demand. Since the cache has no upper bounds and never shrinks, it 
grows to accommodate the peak async I/O usage, and keeps that memory forever. 
This can starve the kernel, causing all processes to sleep and the system to hang. 


Because disks on esp2, esp3, and esp4 are not seen by miniroot, you can 
only install from SCSI bus 0 or 1. 


When formatting disks on Sun-4s, if the defect list happens to be large enough to 
require two disk blocks, you may get a format failure: 


formatting... done 


assertion. failed: file “ctlr-sesi.c’, Line: 2331 


The label is not written on the disk, so subsequent invocations of format will 
indicate the disk as <drive type unknown>. This is due to a problem with 
reads/writes of more than one sector at a time on disks using group] commands. 
A patch is available through your local Sun Answer Center if your system is 
under warranty or if you have a support contract. 


Trap does not recognize the Mbus timeout and signal a SIGBUS when a data 
fetch of a nonexistent device memory address is requested; “Unexpected trap” 
error message is displayed. A patch is available through your local Sun Answer 
Center if your system is under warranty or if you have a support contract. 


If an RFS domain has both primary and secondary name servers, you must start 
the primary name server first and then, within one to two minutes, start a secon- 
dary server. The password (if there is one) for the primary server must be given 
before the password for the secondary server. 


When the primary server is started it tries to contact a secondary name server, if 
one is listed in the file /usr/nserve/rfmaster. If the secondary server 
isn’t started, or isn’t started in time, the primary server “times out”. 


If the maxusers parameter in the kernel configuration file is set too high, the 
resulting kernel will panic during the system boot sequence with one of the fol- 
lowing two messages: 


panic: insufficient virtual space for segu: nproc too big? 


Watchdog Reset! 


If this occurs, reboot the system using the generic kernel and make a new custom 
kernel using a smaller maxusers value. The maxusers limit varies, 
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Using kadb Via tty Port on 
SPARCstation 2 Hangs 
Console tty (1043532) 


10.3. Graphics 


Using the SunView Version of 
the OPEN LOOK Deskset on 
24-Bit Systems 


SunPHIGS 1.2 May Not 
Double Buffer Correctly on a 
GS Graphics Accelerator 
(1041918) 
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depending on the system and the way its kernel is configured. See “Maximum 
maxusers Values for Sun-4, Sun-4c, Sun-4m Servers” in Section 8.3 of the 
Release Manual for more detailed information. In general, the following 
maxusers values should be safe: 


sun4: 286 
sun4c: 225 
sun4m: 45 to 185 


If you use kadb to debug your system and your console device is one of the tty 
ports, it will hang in respect to UNIX the first time you enter kadb. The system 
remains perfectly usable and can be accessed via the other tty, frame buffers, or 
over the network. However, any UNIX processes attempting I/O to the console 
tty will hang. 


The SunView version of the OPEN LOOK Deskset displays strange colors and 
other undesired effects when used on a 24-bit frame buffer. This includes the 
TC, GXP and GS systems. We recommend you do not use the SunView version 
of OPEN LOOK Deskset with any of these systems. 


If you are using canvas region workstations in SunPHIGS 1.2 on a GS graphics 
accelerator, one of the workstations may “flash” while another is updated. This 
occurs when an application has been inactive for 30 seconds or more and then 
switches its focus from one canvas region workstation to another. The work- 
around is to set the SunView environment variable shown below: 


This problem has been corrected in SunPHIGS 1.3. 
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10.4. Network 


Second Ethernet Starts Even 
When Not Configured 
(1066220) 


Some Network Services 
Invoked by inetd May Fail 
to Run (1045211, 1042491) 
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If you have multiple ethernets and only configure the primary ethernet (1e0) the 
second ethernet (le1) seems to be started automatically even though there is no 
hostname.lel file. The second Ethernet is not actually started, but it is left 
with the IFF_RUNNING flag set; no IP address is configured onto the interface. 
This has no effect on any other software in the system. You may see the follow- 
ing error message during bootup: 


le0: No carrier - transceiver cable problem? 


leQ: RARP timed out 


These are harmless messages and can be ignored. To disable these messages, 
edit /etc/rc.boot (save old one) and comment out the following line: 


ifconfig -ad auto-revarp up 


Subsequent reboots will not show these errors. 


The program inetd(8c) provides an internetwork daemon that invokes network 
services listed in the file /etc/inetd.conf. On rare occasions, the service 
invoked fails to run. The service most likely to fail is t £tpd, which is neces- 
sary for booting diskless clients. Two other services that may be affected are 
in.cmsd (OpenWindows Calendar Manager) and in. comsat (Mail Tool). 


If a service invoked by inetd fails to run, terminate inetd and restart it. To 
terminate inetd: 


1. Get the process ID for inetd: 


The process ID is the first number in the process table that results. In the 
example below, the process ID for inetd is 153. 


Note: Sample display; contents may vary, depending on user input and the system used. 


2. Become superuser, terminate the process (153 in the example), and restart 
inetd: 
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ypinit on Slave Server 
Generates Error Message 
(1029284) 


RFS Mounts on Directories 
with Inodes Greater Than 64k 
Will Fail returning getwd 
fails: cannot find 


Internet Domain Name 
Service (DNS) Requires 
Hostnames in 
/etc/hosts.equiv and 
.rhosts 
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S su ae Hh reser surges meta eerun 
-Password: [rootpassword) = sss 
Cp a tos 

-# /usr/etc/inetd 


Running ypinit -s ypmaster on an NIS slave server may generate multiple 
error messages on the screen, among them: 


RPC Program Not Registered 


The transfer of maps takes place correctly, in spite of the error messages that may 
partially fill the screen. 


You can prevent the error messages by logging in to the master server as root 
and entering ypxfrd to start the master server’s ypxfrd daemon before you 
tun ypinit on the slave server. 


You can also prevent the messages from appearing if you have the ypxfrd dae- 
mon start automatically when the master server boots. To do this, edit the file 
/etc/rc.local as shown: 


if [ -f£ /usr/etc/ypserv -a -d /var/yp/ ‘domainname’ ]; then 
ypserv; echo -n ’ ypserv’ 


ypxfrd; echo -n ’ ypxfrd’ 


RFS will truncate inode numbers of 64K or greater. If you plan on advertising 
RFS resources, be sure that the file system to be mounted is not capable of creat- 
ing inode numbers of 65536 or greater. The maximum possible inode number 
for a file system can be found by executing df —i and adding the iused and 
ifree values for the file system. 


If you are running NIS in conjunction with DNS and the host is not in your NIS 
map or DNS domain, you must have entries for the hostname in the files 
/etc/hosts.equiv and .rhosts. 
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10.5. Utilities 


cpio Will Not Copy Rock 
Ridge Symbolic Links 
(1069718) 


Timeout Message for 
Preinstalled Systems Installed 
with QuickInstall 


maxcontig Parameter 
Cannot be Set Above Seven 
with tune —a (1043735) 


S 
® 


Because of a problem with cpio copying files with symbolic links from a Rock 
Ridge file system, you may have to use tar (1). 


Preinstalled Desktop SPARCsystems and Sun-4 and Sun-4c machines which 
have been installed with the QuickInstall option to suninstall will display a 
timeout message when booting: 


ifconfig: RARP: timeout 


The system is attempting to do automatic network configuration, but the network 
is not set up correctly, or the system may not be attached to a network. In the 
latter case, another message will be displayed: 


| 1e0: No carrier - transceiver cable problem? 


Both of these messages can be ignored on the non-networked installation. 


The messages can be helpful when trying to debug Automatic Network 
Configuration. For the “RARP: timeout” message, the system information could 
not be obtained from the NIS database in the hosts, ethers, or bootparams maps. 
The “leO: no carrier” message indicates a problem with the tranceiver cable; it is 
probably not connected or is connected incorrectly. 


If Automatic Network Configuration is not your goal, then the ‘““RARP: timeout” 
message 1s to be expected. 


If you use the —a option of tunefs(8) to set the maxcontig parameter for a 
partition, you must set maxcontig at 7 or less. A value greater than seven 
does not generate an immediate error message, but prevents you from mounting 
the disk partition you specified. When you try to mount the partition, you get an 
error similar to the following: 
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uucp Password File Problem 


at Boot Up 


Error Messages During Heavy 


IPI Disk Activity (1036367) 
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As explained below, an interaction between the password file entry for uucp 
and the uucp entry in /etc/rc at bootup may cause the following error mes- 
sage: 


su: uucico: illegal option -- c 


usage: uucico [-xNUM] [-r[0|1]] -sSYSTEM -uUSERID -dSPOOL —~iINTERFACE 


The default passwd entry for uucp is 


uucp:*:4:8::/var/spool/uucppublic: 


When adding uucp logins to the passwd file, it is common to make uucico 
the login shell. In this case, the passwd entry for uucp becomes: 


uucp:*:4:8::/var/spool/uucppublic:/usr/lib/uucp/uucico 


This becomes a problem in interaction with /etc/rc. The default /etc/re 
file has the following line, which is executed upon boot up: 


su uucp —-c /usr/lib/uucp/uusched & 


Normally, the -c option of su would be passed along with the rest of the com- 
mand line to the shell. But in this special case the shell is uucico, not 
/bin/sh, which is the default if no other shell is specified. Since uucico 
doesn’t have a —c option, the option fails and the su: uucico: illegal 
option error message results. 


If you get the error message at boot up, you can remove the uucico field from 
the uucp’s passwd entry. However, although this takes care of the problem 
with /etc/rc, it creates a new problem in its place: the absence of the 
uucico field means that remote systems calling in to do uucp transfers will be 
prevented from carrying them out. 


During heavy IPI disk activity, error messages similar to the one below may 
appear. They can be disregarded. 


Apr 9 13:43:46 muishu vmunix: id003h: block 849694 (849694 abs): 
write: Conditional Success. Data Retry Performed. 
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10.6. Compiler 


SPARC Compiler With SPARC compilers earlier than compiler release 0.0 (in 1990) 
Optimization Level -02 Can optimization level -O2 (cc -Oorcc -O2) can cause the SPARC assembler 
Produce Incorrect Code to generate incorrect code. In the following C program, the assembler code pro- 
(1031879) duced with level —O2 optimization does not test the while loop, which leads to 


an infinite loop. 


int boothowto = 1; 


int 
main () 
{ 
int unit; 
if (boothowto & 1) { 
retry: 
unit = -1; 
while (unit == -1) { 
if (unit != -1) { 
printf ("unit = td when it should be -1!0, 
unit); 
exit (1); 
} 
unit = 0; 


print_unit (éunit); 
} 
} else { 
unit = 0; 


goto retry; 


} 


print_unit (unitp) 
int *unitp; 
{ 
printf ("print_unit: unit = sd0, *unitp); 


To prevent the problem, compile with -O~M specified to the assembler. If you 
are running the assembler directly, this is: 


If the assembling takes place as part of compiling a high-level language, it is: 
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10.7. Hardware 


Disk Label of Second 104MB If you get the following message the first time you turn your system on, your 
Disk on Desktop second 104MB disk has an incorrect disk label. 
SPARCsystem May Be 


Incorrect (1045344) sdl at esp0 target 1 lun 0 
sdl: corrupt label - wrong magic number 


sdl: Vendor ’Quantum’, product ’P105SS’, 205075 512 byte blocks 


To correct the label, carry out the following steps: 


1. Become superuser and use format(8S) to reformat your second disk 
(sdl): 


2. Enter 1 to select your second disk: 


3. Enter commands as shown in the following sequence of screen prompts and 
user responses: 


S 
RG S U n Revision A of December 1991 


microsystems 


10-12 SunOS 4.1.2 Release Manual 


“format> defect = ee oo Cee 


de ‘commit ce eres 
“working. list. was not modified. 


defect> quit 
FORMAT MENU” 


| facmaes tom cas nce 
Ready to. format ormatting cannot be 
and takes 2. minutes (estimated) . 


Fomnattlag.. done one 
ea eae he 


“FORMAT ‘MENU: 


“formatoquit 


10.8. PROM 

Long Reset Time on Sun-4m When you install miniroot ona SPARCsystem 600MP system, the time 

(1067283) between copying the miniroot to disk and rebooting the miniroot is 
between 45 and 60 seconds; the screen is blank during this time, which may 
cause you to think something is wrong. 

Problem Redirecting I/O to If you have a SPARCstation 2 with a CG6 framebuffer, entering ttya io at the 


Terminal on SPARCstation 2 ok PROM Monitor prompt to redirect I/O to a terminal fails and generates the 
with CG6 Framebuffer error message: 


(1042243) 
[ Memory address not aligned | 
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Sun-4/330 Cannot Boot 
Miniroot from Internal Disk 
with Some PROMs (1044450) 


Some Older Sun-4s and Sun- 
3s May Not Be Able to Boot 
Miniroot under SunOS 4.1.X 


Bug in Some Boot PROMs 
Prevents munix from 
Booting the Miniroot on IPI 
Drives (1032123) 
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Attempting to reboot generates the message: 


panic: data fault 


To redirect I/O to a terminal, you need to enter the following commands at the 
ok PROM Monitor prompt and then power cycle your machine. 


When your system comes up, the output will be redirected to the terminal. 


The boot PROMs on some Sun-4/330s prevent them from booting the miniroot 
from an internal SCSI disk. The workaround for this is similar to the workaround 
given in the description of bug 1032123 below. The only difference is that in 
Step 3 of the workaround, all occurrences of id000b must be replaced with the 
boot address appropriate to your system. 


Old boot PROM revisions on some Sun-3 and Sun-4 systems may prevent them 
from booting the miniroot under SunOS 4.1.X. When this occurs, messages 
similar to the following are displayed: 


checksum xxxuxxxxx != yyyyyyyyyy 
trying to boot anyway 


Illegal Instruction .... 


Error/doing reset 


The workaround for this is similar to the workaround given in the description of 
bug 1032123 below. The only difference is that in Step 3 of the workaround, all 
occurrences of id000b must be replaced with the boot address appropriate to your 
system. 


A bug in SPARCserver 390 boot PROMs earlier than 3.0.3 and in SPARCsystem 
4X0 boot PROMs earlier than 3.0 prevents munix from booting the miniroot on 
IPI drives. 


munix (Memory Unix) is a reduced version of UNIX that runs entirely in RAM 
and contains the format program for formatting and partitioning disks. munix 
is loaded off the release media primarily so that format can be used on disks 
that will contain system data. 


The miniroot is a minimal version of UNIX that is loaded into the swap partition 
of the system disk in order to run SunInstall. 
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Prior to SunOS 4.1, if you booted munix to run format, you had to boot off 
the release media a second time in order to copy the miniroot to disk and then run 
SunInstall. Now, a script automatically copies the miniroot to disk when 
you quit the format program and allows you to boot the miniroot from disk: 


If you now enter 1 to boot the miniroot from an IPI disk, the PROM bug prevents 
booting and generates one of the following messages: 


checksum xxxxxxxx != yyyyyyyyyy 
trying to boot anyway 


Illegal Instruction .... 


Error/doing reset 


There is a workaround which starts at the point where the screen displays: 


Mini-root installation complete. 


What would you like to do? 
1 - reboot using the just-installed miniroot 
2 - exit into single user shell 

Enter a lor 2: 


Carry out the following steps to boot the miniroot and use SunInstall. 
1. Halt your system: Press 

- (a) 
2. Enter the command for booting CD-ROM. 


A series of screen prompts follows. 


3. Respond to the screen prompts as follows: 
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Spurious Warning Message 
from IPI Disk Controllers 
(1023347) 


Boot PROMs 3.0 and Higher 
Can Only Boot Off IPI Disk 
Units 0 and 1 (1037179) 


Installing miniroot on 
id010 or Higher Causes 
Invalid Boot String (1069384) 


CG6 Frame Buffer Generates 
Errors with Some PROMs 
(1030399) 


10.9. Sundiag 


Sundiag Reports Loopback 
Errors While Testing mcp 
(1068117, 1068776) 
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Note: Sample display; contents may vary, depending on user input and the system used. 


When booting from IPI disks the following message may be displayed: 


vmunix: idcO: ctlr message: ’/Warning: bad EEPROM checksum’ 


The warning is harmless and may be ignored. 


A boot PROM bug in PROMs 3.0 and higher limits booting to IPI disk units 0 and 
1. In combination with the following bug, this restricts systems to installing 
SunOS on either id000 or id001. 


After installing the miniroot on any disk ID higher than id007 (id010, for 
example), an invalid boot string is generated; if you attempt to reboot using the 
just-installed miniroot, the boot will be attempted from id(0,28,1) 
instead of the correct id(1,0,1). 


On SPARCserver 390s with PROMs earlier than 3.0.2 and on SPARCsystem 4X0s 
with PROMs earlier than 3.0, the CG6 frame buffer may generate screen errors or 
garbage screen when dmesg runs on the console. Problems include keyboard 
buffering (characters not being printed on the screen or recognized until a car- 
riage return is entered), and mouse event states not being reset (for example, if an 
event state is not reset, once you scroll up on a scrollbar, you cannot scroll down, 
or do anything else with the mouse). 


If you install the SunLink HSI/S 1.0 software after installing SunOS 4.1.2 on 
your system, the sundiag provided with the HSI/S distribution will overwrite 
the SunOS 4.1.2 sundiag, which includes bug fixes for bugs 1068117 and 
1068776. 


To preserve the bug fixes, save the SunOS 4.1.2 
/ausr/diag/sundiag/sunlink test file prior to installing the HSI/S 
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Sundiag 2.3 Fails Startup 
Probe Because of False 
devinfo (1071674) 


There is No fddi Test in 


Sundiag 2.3 Alpha 5 (1070359, 


1070602) 


10.10. Sun 386i 


386i diskless client is not 
added successfully (1071266) 


Sun386i Server Kit Causes All 
Clients to Automount /home 


(1043173) 


S 


Ss 
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software (for example, move the sunlink file to sunlink.orig), and 
restore it after installing the HSI/S software (move sunlink.orig back to 
sunlink). 


Sundiag uses the /usr/etc/devinfo program in its probing routine when it 
first starts up. devinfo finds eight drives for any IPI controller, regardless of 
whether there are eight drives on the controller. The result is that sundiag 
displays probing failures such as the following if fewer than eight drives are on 
an IPI controller: 


bench_3401 ./probe ERROR: /dev/rip0c open error: No such device 


Sundiag 2.3 does not include an option to test Sun-4m VME fddi devices. A 
.usertest file containing the following line can be used in 
/usr/diag/sundiag to have nettest verify the device: 


nettest, Fddi, net _fddiO D=10 


When installing 3861 diskless client on SunOS 4.1.2, the 386i SunOS 4.0.1 server 
kit script, sun386client tries to modify /var/yp/Makefile, checking 
only for the existence of the auto.master map. Only two of the three neces- 
sary NIS maps are added; auto.vol, which is needed by 386i clients, is not 
added. 


On a heterogeneous server, the Sun386i Server Kit creates automount maps in 
/etc/fstab for all clients, including non-386i clients. This means all clients 
run automount to mount home/servername. The problem is that all non-386i 
clients already had /home entries in fstab. Thus they have separate auto- 
mount /home entries and non-automounted /home entries. 


The workaround is for the server and all non-386i clients to edit 
/etc/rc.local and change the line 


[ autonount && echo -n ’ automount’ | 


to 


[ automount “—m && echo -n ’ automount’ | 
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10.11. Documentation 


Corrections to System and 
Network Administration 


Misleading Instructions on 
Using a UNIX file for Swap 
Space (1039946) 


Error Message and 
Explanation Incorrect 
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On page 247, Step 6 of the instructions for using a file to create extra swap space 
calls for entering the following command: 


fro 


The command is correct for setting up a file to be used by a client system over 
the network. The command fails if it is used to create a local file on the same 
machine that will be using it. Characteristic error messages are: 


assertion failed panic: bn! UFS hole 


and 
watchdog reset 


To set up a local file for a standalone system or server to use for added swap, you 
must leave out the —n option: 


In Table 21-6 (incorrectly labeled “Table 21-1’’), page 687, an error message and 
its description are incorrectly given. The error message is: 


No uucp server A TcP/IP call is attempted, 
but there is no server for vuucp. 


The description should read: 


No uucp service number No entry for uucp/tcp can be found in 


/etc/services, but there is a hyphen 
in a Systems file entry port field 
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Unresolved Cross References 


Corrections to the SunOS 
Reference Manual 


Remove skyversion(8) man 


Page 


Correction to Network 
Programming Guide 


Incorrect Warning at 
Beginning of Chapter 10 


10.12. CD-ROM 


Actions Causing SunCD to 
Hang System (1033100, 
1032990) 


On pages 257 and 261, the reference “See the section on 
@TitleOf(repair.sector)” should read: 


See the section on Repairing a Defective Sector 


On page 269, the reference “See the section on @TitleOf(defect.list)” should 
read: 


See the section on Creating a Defect List 


On page 279, the reference “See the section on @TitleOf(using format)” 
should read: 


See the section on Using format for Basic Maintenance 


The printed version of the skyversion(8) man page is specific to Sun-2 sys- 
tems, which are no longer supported. It should be ignored. The online man page 
has been removed. 


The warning at the beginning of Chapter 10 of the Network Programming Guide 
is in error. Socket-based IPC has not been superseded by the UNIX system 
Transport-Level Interface; any statements implying that it has been are incorrect. 
The first paragraph in Chapter 10 should be replaced with the following text: 


This chapter provides detailed information, with various examples, on the 
UNIX system Transport-Level Interface. This interface is intended to pro- 
vide the user with a more structured transport-level interface than that which 
is provided by the socket interface, and as such deliver tranport- 
independence in a transparent manner. 


TLI does not supersede sockets but is intended to offer the developer another 
mechanism by which to assure that applications under development can and 
will exist autonomously, regardless of the network or transport protocols. 


To prevent your system from hanging when using a CD-ROM, do not: 


e Attempt to access a defective or “bad” CD-ROM (one that contains recover- 
able recording errors); 
e Access a non-HSFS disc on the CD-ROM drive. 
S, 
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SunInstall Can Only Find 
CD-ROM at sr0 (1044687) 


CD-ROM eject(1) May Not 
Work on a Read Failure 
(1033102) 


CD-ROM Error Messages on 
Console (1032918) 


10.13. Library 


textdomain(3) Requires 


Two Arguments (1045495) 
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e Eject the CD-ROM while the CD-ROM file system is still mounted. 


e Tum the CD drive off while the CD-ROM file system is still mounted. 


SunlInstall has an internal list of devices it can use for reading installation media. 
The only CD-ROM device included is sr0. 


If for some reason the CD-ROM driver can’t read a CD (as in the case of a defec- 
tive disc) the eject command may also fail, returning the following error mes- 
sage: 


You can eject the disc manually. 


Messages similar to the one below may appear on the console at various times, 
most often when you mount the CD-ROM or run demos from it. They can be 
disregarded. 


sr0a: read recoverable, block 198000 


sense key(0xl): soft error, error code(0x18): soft data error 


The SunOS Reference Manual documents the text domain(3) library function 
as only requiring a single argument. However, the code for textdomain () 
expects a second argument. Without the argument, a program calling 
textdomain() dies with a segmentation violation. The second argument has 
no operational effect. It was called for in the original design of the function, but 
when the design changed and it was no longer necessary, the code that tested for 
its presence was never dropped. 


The workaround for the problem is to use a dummy second argument in pro- 
grams that call textdomain (): 


textdomain ("domain_name","") ; 
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10.14. Miscellaneous 


mt status and mt asf 
Commands Under SunOS 
4.0.3 Not Compatible with 
SunOS 4.1.X 


You Cannot Install SunShield 


on SunOS 4.1.2 using 
cdmanager (1069654) 


10.15. OpenWindows 
Version 2 


You Must Remove or Edit 
.xinitrc File in /home 


You Must Move 
app-defaults Directory 


Running NeWS Applications 
on a Non-Networked 
Standalone System 


S 


The use of the mtceTsTatus ioctl data structure changed in SunOS 4.1. Asa 
result, SunOS 4.0.3 (and earlier) binaries formt status andmt asf cannot 
be used with SunOS 4.1.X. 


See the workaround in Chapter 7 of the Release Manual. 


If you already have a .xinitrc file in your home directory, make sure you 
either remove it or edit it according to the instructions in Chapter 2 of the 
OpenWindows Installation and Start-Up Guide before you start OpenWindows 
for the first time. 


The app-defaults directory in /usr/openwin/lib/app-defaults 
should be moved to /usr/openwin/lib/X11/app-—defaults before ins- 
talling OpenWindows on your system. To make the change, become superuser 
and enter the following commands: 


In order to run NeWS applications on a standalone workstation that is not con- 
nected to a network, you must start OpenWindows with the -noauth option so 
that security is not enabled. This is necessary to bring up the tutorial as part of 
the default desktop on a standalone workstation. If the -noauth option is not 
used, the following error message will be displayed: 


XNeWS Network security violation 


Rejected connection from: hostname 
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OpenWindows Invoked from 
Command Line does Not 
Reset Foreground Color 
Correctly (1041554) 


Exiting OpenWindows May 
Cause Display of Error 
Messages (1044695) 


Control-C When 
OpenWindows Version 2 is 
Starting Freezes Window 
System (1039856) 
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If you invoke OpenWindows from a command line, it will not reset the fore- 
ground color when it exits. For example, if you are in color Sun View and invoke 
OpenWindows from the shell (%) prompt, when you exit OpenWindows, you will 
not be returned to the initial SunView color foreground. To reset the foreground 
color, enter the command: 


In some cases, when the OpenWindows window manager (ol wm(1)) exits a pro- 
gram, an error message is generated. This may happen when fasthalt(8) or 
fastboot(8) are used. Examples of the error messages generated are: 


XIO: fatal IO error 32 (Broken pipe) on X server "0.0" 


and 


WIN ioctl number c0286722: Inappropriate ioctl for device 


You can safely ignore the messages if they are displayed when you intentionally 
exit OpenWindows. 


The messages are generated when olwm exits an X11 program that is not fully 
compliant with the ICCCM mechanisms for interacting with a window manager. 


If you press your interrupt character (usually (Control-C)) to halt OpenWindows 
when it is starting up, the OpenWindows windows still come up on screen and 
the mouse cursor can be moved across them, but all mouse and keyboard buttons 
are frozen, so that no window activity is possible. This is because the Window 
Manager was interrupted, but other components of the window server were not. 
Since the window system cannot respond to your keyboard in this situation, you 
need to rlogin to your own system from another machine on the network and 
stop the window server. To stop the window server: 


1. Get the server’s process ID: 


If you cannot rlogin to your system, call your local Sun Answer Center for 
assistance. This problem is corrected in OpenWindows Version 3. 
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Error Message for Incorrectly 


Set Keyboard DIP Switches 


Problem with F1 (Help) Key 
on Type-4 Keyboards 


Error Message for Incorrect 
Permissions on /tmp 
Directory 


Do Not Resize Text 
Sub-Window Smaller Than 
the Top of the Bottommost 
Split 


S 


In the unlikely event that your keyboard DIP switches are set incorrectly, you 
will see the following message when you start up OpenWindows: 


ClassKeyboard couldn’t initialize the keyboard. 


Process: Oxlebc9c (Unnamed process) Error: undefined 

Stack: (NeWS/interest.ps) marker /BasicKeyDicts marker 

Executing: ascii000 

At: {*ascii000 ascii0SO ascii0OL ascii0SO asciiC00 asciiC00 asciiC00 
asciiC00} 

In: Reading file (’NeWS/interest.ps’,R) 

Sic transit gloria PostScript 

giving up. 


xinit: Connection refused (errno 61): unable to connect to server 


If you are using a Type-4 keyboard and SunOS 4.1.X, all DIP switches ona U.S. 
keyboard must be set to "0" or "off". See Chapter 3 of the OpenWindows Instal- 
lation and Start-Up Guide for the settings for international keyboards. 


On Type-4 keyboards, the F1 (Help) key does not work properly if either Caps 
Lock or Num Lock is on. 


If OpenWindows displays the following error message: 


XNeWS: there is already a NeWS server running on :0 

giving up. 

/usr/openwin/bin/xinit: Permission denied (errno 13): unable to 
connect to X server 


Check the permissions on the /tmp directory. They should be: drwxrwsrwt. 


Resizing split text subwindow smaller than the top of the bottommost split 
causes the program that owns the text subwindow to crash. Any changes in any 
of the program’s windows that have not been saved previously are lost. This bug 
affects File Manager, Mail Tool, and Text Editor, as well as all other application 
programs that use text sub-windows. If you are using the split feature of text 
sub-windows, you should not resize the text sub-window smaller than the top of 
the bottommost split. 
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Mail Tool: Running out of 
Disk Space in /tmp 


Do Not Disable Scrolling in 
One of the Windows of a 
Split-Screen Command Tool 


File Manager Can Crash If 
Too Many Editing Sessions 
Are Started 


File Manager’s Wastebasket 
Icon May Be Invisible Or 
Appears As a Short Text 
String with No Picture 
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Mail Tool does not handle running out of disk space in /t mp gracefully. If you 
have too large a mail spool file, or too little space in /tmp, Mail Tool may give 
an error message, terminate, and possibly leave a lock file, which you will need 
to remove, in /usr/spool/mail. The name of the file is username.lock. 
To remove the lock file, enter: 


If Mail Tool runs out of space in /tmp while running, it is possible that deleting 
messages from the /n Tray may result in the deleted messages being duplicated 
and sequenced out of order. 


It is recommended that you hold down the size of your spool file by limiting the 
number of messages in your In Tray. In addition, you can conserve disk space by 
removing unnecessary files from the file system containing /tmp. 


Disabling scrolling in one of the windows of a split-screen Command Tool may 
cause it to crash. 


The File Manager can crash if too many editing sessions are started in a short 
period of time. When this happens, all unsaved changes are lost. To prevent 
such crashes, Sun strongly recommends that you do the following: 


1. Select Tool Properties from the Properties menu button on the File 
Manager control panel. 


2. Click on the Other option next to Default Document Editor. 
3. Fill in the blank with: 
textedit "SFILE" 


4. Press the Apply button at the bottom of the window. 


If the File Manager’s Wastebasket icon appears as a short text string with no pic- 
ture, double-click on the string. This will open up the Wastebasket window. 
When you close the Wastebasket window, the icon will assume its normal 
appearance. 


If the Wastebasket icon is initially invisible, exit and restart the File Manager. In 
most cases, this will solve the problem. If the icon is still not visible, either click- 
ing around the edge of the screen where your other icons are located or select 
Screen Refresh from the Utilities menu. Screen Refresh produces a 
short text string, as described above. Follow the previous instructions to get the 
normal Wastebasket icon. 
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Application Programs Can 
Move Windows in Front of the 
Lock Screen on Monochrome 
Monitors 


Adjusting for Open Windows 
Monitors with Overscan 
Capabilities 


On monochrome monitors, application programs can move new or updated win- 
dows in front of the Lock Screen. As a result, the contents of a window may be 
displayed even when the screen is locked. This can happen, for example, if you 
lock the screen as soon as you Start saving a large Mail Tool infile. When the 
Mail Tool save is completed, the message view window will still be displayed, in 
spite of the screen lock. Color monitors do not exhibit this problem. 


OpenWindows Version 2 supports monitors with overscan capabilities. For 
monitors running in overscan mode, the server can be started up with an adjusted 
viewing size in order to compensate. 


In future systems, the need to run in overscan mode may automatically be deter- 
mined at startup time. However, there will be occasions when X11/NeWS is run 
on a second non-overscan monitor, or on monitors that are not properly aligned, 
or are of an unusual size. In these cases, overscan mode may have to be shut off 
or the dimensions of the visible area changed. To allow for the eventualities, the 
following command-line arguments will be supported by X11/NeWS once the 
overscan code 1s installed. 


e -dev [fbname] 


This option will tell the server what device to display on. This replaces the 
usage of the FRAMEBUFFER environment variable in OpenWindows 1.0. 


@ -overscan [percent] 


This option instructs the server to shrink the visible area by the indicated 
percentage and perform the necessary offsetting. If a percentage of —1 is 
given, the shrinkage will be set to the default. If a percentage of 0 is given, 
overscan mode will be disabled and the server will use the full size of the 
screen. This will allow users to override any defaults if a particular monitor 
doesn’t behave to their liking. 


In addition, if the —-overscan option passes a non-zero value, it will enable 
the special overscan functionality (the flooding of the unused border regions 
with the root X color/pattern and the constraining of the cursor to the root 
canvas). 


e -rect [LTWH] 


This option instructs the server to use a viewing area described by the rec- 
tangle passed in. Note that this mode will not perform the special 
cursor/border functions which are part of overscan mode unless overscan 
mode is also enabled. This option simply sets an explicit viewing area. 


Examples: 
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GX Hardware Cursor May Be There are some cases in which the GX hardware cursor is left on the screen after 


Left on Screen after Exiting exiting OpenWindows. The workaround is to compile and run the following pro- 
OpenWindows gram: 
R sun Revision A of December 1991 


10-26 SunOS 4.1.2 Release Manual 


GX with Open Windows on 
Multiple Screens: Some 
Operations May Leave Cursor 
Invisible 


/* 

* gxcursor -- disable GX cursor 

* to compile: cc -O -o gxcursor gxcursor.c -lpixrect 
ad § 

#include <stdio.h> 

#include <sys/types.h> 

#include <sys/ioctl.h> 

#include <sun/fbio.h> 

#include <pixrect/pixrect.h> 

#include <pixrect/memvar.h> 


struct cg6épr { 


struct mprp data mprp; | /* memory pixrect simulator */ 
int fd; /* device file descriptor */ 
struct pr_size cg6_size; /* screen size */ 
caddr_t cg6_fbc; /* FBC base */ 
caddr_t cg6_tec; /* TEC base */ 

}; 

#define THCOFFSET (5 * 4096) 

#define THC_CURSOR Ox8FC 


main(argc, argv) 
int argc; 


char *argv[]; 


char *dev = argc > 1 ? argv{1] : "/dev/fb"; 
int fd; 
struct fbhgattr fbhattr; 


Pixrect *pr; 


if ((fd = open(dev, 2, 0)) < 0) 
perror (dev); 

if (ioctl(fd, FBIOGATTR, &fbattr) < 0 || 
fbhattr.fbtype.fb type != FBTYPE SUNFAST_ COLOR) 
fprintf(stderr, "device *s is not a GX frame buffer0, dev) 


(void) close(fd); 


if ((pr = pr_open(dev)) == 0) 
fprintf(stderr, "pixrect open failed for %s0, dev); 


* (int *) (((struct cg6épr *) pr->pr_data)->cg6_fbe + 
THCOFFSET + THC_CURSOR) = Oxffe0ffe0; 


exit (0); 


When you run on a GX and have OpenWindows displayed on multiple screens, 
operations that warp the cursor to a new position (such as scrollbars and 
pop-ups) may leave the cursor invisible until you move the mouse. This 
behavior does not start until after the mouse cursor visits the non—-GX screen. 
Once the disappearing cursor starts, it is non—deterministic (due to a race 
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condition), so it shows up about 50% of the time. Three workarounds follow: 


e Setthe Scrollbar Pointer Jumping and Pop-up Pointer 
Jump ing properties in the ‘Mouse Settings” Workspace property sheet to 
off, then restart OpenWindows. This fixes the most common X View 
symptoms. 


e Adjust the OpenWindows.PopupJumpCursor and 
Scrollbar.JumpCursor properties in the ~/.Xdefaults file to be 
False. For example: 


OpenWindows.PopupJumpCursor: False 


Scrollbar.JumpCursor: False 


This fixes the most common X View symptoms. 


e Permanently disable the new hardware cursor tracking feature in the kernel 
by adjusting a kernel variable and rebooting: 


# adb -w 
snot core 


Under this workaround, cursor tracking may lag behind mouse motion in 
some circumstances. 


In XView, the number of panel items is unlimited. However, after a certain point, 
the server will run out of virtual memory with the message: 


BadAlloc Xerror 


Due to a bug in the XView canvas package, trying to set some canvas paint win- 
dow attributes using CANVAS_PAINTWINDOW_ATTRS in the create call of a canvas 
will not work correctly. The attributes that fail are wIN_BIT_GRavity and any- 
thing that adjusts the window’s event mask (e.g., WIN_CONSUME_EVENT(S) and 
WIN_IGNORE_EVENT(S)). The work around is to set the 
CANVAS_PAINTWINDOW_ATTRS after the canvas has been created. 


For example, given: 
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canvas = (Canvas)xv_create (frame, CANVAS, 


oF 
CANVAS_PAINTWINDOW _ATTRS, 
WIN BIT GRAVITY, SouthWestGravity, 
WIN_CONSUME_EVENT, LOC_DRAG, 


canvas = (Canvas) xv_create (frame, CANVAS, 


xv_set (canvas, 
CANVAS _PAINTWINDOW_ATTRS, 
WIN BIT GRAVITY, SouthWestGravity, 
WIN_CONSUME_EVENT, LOC_DRAG, 


SunView Compatibility under If you have a SPARCstation with GS graphics, the Sun View compatibility 


OpenWindows Does Not feature of OpenWindows does not work correctly. When running a SunView 

Work with GS Systems application under OpenWindows, the screen goes blank and the XNeWs server 

(1048981) eventually dumps core and terminates. 

Using DNI e If you mn the X11/NeWS server over DNI, you will crash the server if you 
view an access list using xhost after adding a host to the list with 
newshost. 


e You must unset the environment variable DNI_X ENABLE before starting 
the server if DNI is not in a mode that accepts connections. 


e If you turn off the network node state while the server is running, you will 
crash the server. 


e You can cut text from an OpenWindows application into a DEC application, 
but not from a DEC application to OpenWindows. 
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The following sections, from OpenWindows Version 3 Product Notes (Part 
Number 800-6387-10), contain important information about this release of the 
OpenWindows software. See the following documents for additional release and 
installation information: 


e OpenWindows Version 3 Release Manual 


e OpenWindows Version 3 Installation and Start-Up Guide 


There are SunOS 4.1.1 patches available in 
SOPENWINHOME/1ib/OSpatches. Do not install these patches on your 
SunOS 4.1.2 system. 


During installation of OpenWindows Version 3 you are given the option of 
removing OpenWindows Version 2: 


Do you want to remove the current contents of 


the /usr/openwin directory? [ylIn] 


Do not respond “y” if you are doing the installation while running OpenWin- 
dows; the system will be in an unstable state if you do. If you exit OpenWin- 
dows before starting the installation and you decide to rrmove OpenWindows 
Version 2, be sure you have room for OpenWindows Version 3, as described 
below. 


OpenWindows Version 3 uses more space than OpenWindows Version 2 — over 
85000 kilobytes for all packages vs. about 40000 kilobytes for all packages with 
OpenWindows Version 2. Be sure you have sufficient space available before 
beginning your SunOS 4.1.2 installation. See Table 10-2 below for information 
about how much space is needed for various OpenWindows configurations. 


The subset sizes for installation packages provided in the OpenWindows Installa- 
tion and Start-Up Guide are incorrect. Table 10-1 below lists the sizes of the 
packages. Note that some of the packages are subsets of the others (see the 
OpenWindows Installation and Start-Up Guide for the contents of each package). 
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Table 10-1 


Table 10-2 


A 
cK 


Installation Packages 


Package and Content 


Required Package 
Online Man Pages 
Library Interface Man Pages 
Online Handbooks 
Optional MIT Release 
Demo Programs 
Demo Images 

Include Files 

Lint Libraries 

Static Libraries 
Sample Source 
Optional Fonts 


Disk Space Required 


27700 Kbytes 
1300 Kbytes 
2100 Kbytes 
2000 Kbytes 
2300 Kbytes 
2800 Kbytes 
5100 Kbytes 
3000 Kbytes 
600 Kbytes 
10700 Kbytes 
7900 Kbytes 
10100 Kbytes 


Table 10-2 below lists the space used by the installation clusters. Note that the 
amount of space requested by the script (“Script Requests”’) differs from what is 
actually used (“Space Used After Install’’). 


Installation Clusters 


Cluster and Content 


Minimal Configuration 

End User 

Advanced User 

Advanced User with Demos 
Programmer* 

Full OpenWindows 


* Does not include Demos. 


Script Requests 


31000 Kbytes 
41100 Kbytes 
43400 Kbytes 
51300 Kbytes 
67700 Kbytes 
85700 Kbytes 


Space Used After Install 


31588 Kbytes 
41233 Kbytes 
43412 Kbytes 
51168 Kbytes 
66556 Kbytes 
74312 Kbytes 


If your disk has the space necessary for the cluster or package (see the column on 
the right in Table 10-2), but not the amount that the installation script requests 
(middle column), the script will not allow you to install. To solve this problem: 


1. Use the df command to find a disk partition — /var/tmp, for example — 


that has extra space. 


2. Move files from the disk partition that you are installing onto to the disk par- 


tition with extra space. 


3. Move enough files so the disk partition that you are installing onto has the 
necessary space (listed in the middle column of Table 10-2 above). 


4. Run the installation script. 


5. Move the files back to the disk partition that you installed on. 
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Missing F3 Fonts with the 
Minimal Configuration 
Cluster 


Installing the Open Windows 
Software with cdmanager 


Running cdmanager Remotely 
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If you have installed the OpenWindows software using the minimal configuration 
cluster, note that this configuration does not include the full set of F3 fonts. Many 
OpenWindows applications, including NeWSprint and FrameMaker for 
OpenWindows, cannot run without these fonts in place and will fail under the 
minimal configuration. 


If you intend to run NeWSprint or other unbundled or third-party applications in 
the OpenWindows environment that require these fonts, you must install a cluster 
that includes the full F3 font set (i.e., the End User Cluster or one of the ones 
listed below it in Table 10-2). See the OpenWindows Version 3 Installation and 
Start-Up Guide for details. 


It is possible to install the OpenWindows Version 3 release with cdmanager or 
cdm under an Openwindows Version 2 session. As noted above, though, do not 
perform the installation in an OpenWindows Version 2 window if you are going 
to remove OpenWindows Version 2 during the installation. 


If you perform the installation of OpenWindows Version 3 in an OpenWindows 
Version 2 session, you can then exit the OpenWindows Version 2 session, set 
OPENWINHOME to point to the newly installed OpenWindows Version 3 
software, run SOPENWINHOME/bin/install_ openwin, and start up the 
OpenWindows Version 3 environment. 


As stated in the CDManager and CDM User Instructions, follow these steps to 
mount your CD-ROM containing the OpenWindows Version 3 software when you 
use cdm or cdmanager: 


When you attempt to run the cdmanager remotely, the following error message 
may appear: 


[ 1d. so: libxview.so.3 not found | 


To avoid this problem, make sure that you have set your environment correctly. 
See “Setting the Environment Correctly” below for more information. Also note 
that any time you run a program remotely, you must xhost the machine with 
the display that you are displaying the program on. 
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OpenWindows Version 3 
Installation and Start-Up 
Guide Corrections 


Start-up 


Setting the Environment 
Correctly 
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Note the following corrections to the OpenWindows Version 3 Installation and 
Start-Up Guide: 


e page 1, Section 1.1: 
Replace the first bullet item with the following: 
“The system architecture must be Sun-4, Sun-4c, or Sun-4m.” 


e page 23: 
Add the following to the last paragraph: 
“The —nosunview option is not supported on the GXplus, TC, GS, or GT 
graphics devices.” 


e Chapter 6: 
Add the following installation troubleshooting note: 
“If you are running OpenWindows with a graphics accelerator, and perfor- 
mance seems poor, the OpenWindows software may have been improperly 
installed. Verify that the OpenWindows software was installed by root, 
that proper suid modes were preserved, and that 
SOPENWINHOME/bin/install_ openwin was run by root. If you 
have access to XGL, run the XGL install_check program to verify that 
DGA is operational. Contact your system administrator for further assis- 
tance.” 


e Appendix A, section A.3, pages 40-41: 
Replace this section with the following: “DGA is supported on all SBus dev- 
ice configurations in table A-1 on page 39. DGA is not supported on any 
VME or P4 device configurations in table A-1 on page 39.” 


The openwin script sets your executable path to have the location of the 
OpenWindows version of the DeskSet tools before the location of the Sun View 
tools of the same name. If you are using the C shell, make sure you run the 
OpenWindows tools first when you start the server. Make sure that your 
.cshrc file does not reset your path to have /bin and /usr/bin before 
SOPENWINHOME/bin and SOPENWINHOME/bin/xview. In addition, the 
openwin script sets your library path. If you do not have your library path set 
correctly, the following error message may appear when you invoke a deskset 
tool from the command line: 


| ld.so: libxview.so.3 not found | 


You may want to add the following lines to your .cshrc file so that your 
environment is set up correctly for remote logins: 


microsystems 


Chapter 10 —Known Problems 10-33 


setenv OPENWINHOME (installed location of OpenWindows) 
setenv LD LIBRARY PATH SOPENWINHOME/1lib:/usr/lib 


set path=(SOPENWINHOME/bin $path) 


Frame Buffer Issues Some frame buffers require special use under the OpenWindows Version 3 
environment: 


e GT 


For OpenWindows applications using the TrueColor visual (for example, 
that use the same color value that is used on a GS framebuffer), the color 
will look brighter (or more washed out) on a GT. This is because the GT 
hardware provides gamma correction to account for the sensitivity of our 
eyes to low intensities. This give GT images that use shading and anti- 
aliasing a higher quality. The gamma correction feature is described in detail 
in the SunPHIGS and XGL Programmer’s Guides. It can be turned off as fol- 
lows: 


“gtes ele ae 1 _ : | _ i 


example: 


Note that graphics (SunPHIGS and XG-based) programs will have lower 
quality images. 


e TC (CG8) 


If CG8 is the default frame buffer, you must specify the device when starting 
up the OpenWindows software with the openwin command: 


Screen Blank (Screensaver) The OpenWindows Version 3 release has an automatic screensaver feature that 
makes the screen go blank after a period of no use. The OpenWindows Version 3 
Release Manual incorrectly states that this feature is enabled by default. To 
enable this feature, you must type the following at the command line: 


examples xset s on 


When you exit the OpenWindows environment, the screensaver feature is turned 
off. For more information, see the xset(1) man page. 


realxfishdb Demo The realxfishdb demo in SOPENWINHOME/demo is broken in the 
OpenWindows Version 3 release. Although the root window will be painted, 
no fishes will appear. You can obtain a working version from the February 1991 
Catalyst CD. 
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Compatibility with the 
OpenWindows Version 2 
Release 


NeWSPrint 


XView 


Devguide 1.1 
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The NeWSprint 1.0 software does not work with the OpenWindows Version 3 
release. Support for the OpenWindows Version 3 release will be in the next 
release of the NeWSprint software. To continue using the NeWSprint software, 
you must re-install it with small_openwin, a stripped-down version of the 
OpenWindows Version 2 software. For more information, see Chapter 12 of the 
OpenWindows Version 3 Release Manual. 


Because error checking has improved with the OpenWindows Version 3 release, 
the XView libraries will catch some common programming errors that were not 
caught with the OpenWindows Version 2 X View libraries. For example, with the 
OpenWindows Version 2 release, not terminating attribute lists with a NULL 
was acceptable. In the OpenWindows Version 3 release, this error can cause an 
application to crash with a SIGSEV error. 


The following is acceptable OpenWindows Version 2 code, but is not acceptable 
OpenWindows Version 3 code: 


xv_set (sliderItem, PANEL MAX VALUE, 100); 


xv_set(sliderItem, PANEL VALUE, 100); 


This is correct code, which will run under OpenWindows Version 3: 


xv_set(sliderItem, PANEL MAX VALUE, 100, NULL); 
xv_set (sliderItem, PANEL VALUE, 100, NULL); 


Using Devguide 1.1, the following pinnable menu code is not correct, even 
though it worked under the OpenWindows Version 2 release: 


caddr_ t *ip; 


MENU_GEN_PIN WINDOW, (Xv_opaque)ip[0], "", 


The code should actually be: 


MENU_GEN PIN WINDOW, owner, "", 


In this example, the menu’s owner was not set correctly to the tool base frame. 
Under the OpenWindows Version 2 release, even though the code is incorrect, it 
will work: the pinned menu unmaps when the tool is iconified. In the OpenWin- 
dows Version 3 release, X View is more rigorous about checking window owner- 
ship: when the menu is pinned and the tool is iconified, the menu stays up. 
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If you see the following message on your screen after you type openwin: 


ld.so: libsunwindow.so.0: not found 
giving up. 


/usr/openwin/bin/xinit: No such file or directory (errno 2): 
unable to connect to X server 


do one of the following: 


e install the SunOS Sunview-Users Subset from the SunOS media (if you want 
to run SunView applications) 


e use the -nosunview option with the openwin command (if you do not 
want to run SunView applications) 


The following Sun applications are not supported under the OpenWindows Ver- 
sion 3 release: 


e SparcWorks Ada 1.1 
e NSE1.3 


NeWS and TNT are not supported on a 4-bit visual. 


The X11/NeWS server may crash on the Xlib function calls, XDrawImage-— 
String() and XDrawImageStringl16(), on an GS framebuffer, when the 
default depth is 24 (e.g., openwin -dev /dev/cg12 defdepth 24). 
This will only occur when the width or the height of the window being drawn 
into is an out-of-range integer value (e.g., a negative number). 


The workaround is to verify the window width and height. Instead of that 
verification, you can use the Xlib function call XFillRectangle() with 
XDrawString(), which will print an error message if the window width or 
height is an out of range value. 


If you choose the Format option from the Extras Menu in a text sw or termsw, 
any 8-bit characters (characters with diacritical marks, such as accents) in the 
subwindow will be lost if LANG is not set to a European language, or LC -ClYPE 
is set to C, or either one is not set at all. To work around this problem, set 
LC_CTYPE toiso_ 8859 1 in your .profile or .cshrce file, as described 
in Chapter 9. 
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Frame Menus and Dynamic 
Locale Changes 


Incorrect Sorting in File 
Manager and Mailtool 
(1053980) 


DeskSet Issues 


Running Deskset Application 
Remotely 


Cutting and Pasting 
Unprintable Characters 


Tape-Reading Limitations 


Problem Returning to 
OpenWindows Version 2 from 
OpenWindows Version 3 


Problem with Mailtool 
Attachments from 
OpenWindows Version 3 
System 
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The frame menus managed by olwm do not always adhere to dynamic locale 
changes. For example, you may initially change the Display Language locale 
through the Workspace Properties sheet successfully. However, subsequent 
locale changes will not affect the frame menu. To work around the problem, 
restart ol wm by exiting the window system and restarting openwin. 


Sorting of file and directory names in File Manager and sorting of mail in Mail- 
tool may be incorrect for locales other than the C locale. 


If you are starting a Deskset application from a remote system that does not have 
OpenWindows stored in /usr/openwin, you will get the error: 


ld.so: libxview.so.3 not found 


To work around this problem, set the LD_LIBRARY_PATH environment vari- 
able on your remote system to SOPENWINHOME/1lib. 


When you Cut and Paste, or directly manipulate a line with non-printable charac- 
ters, it may get truncated if you paste or drag it to a text field. Pasting or dragging 
to a textsw works as expected. 


There is a limitation when reading a tape using the Read Entire List or the Read 
Selected option from tapetool. The total buffer size of the tar command cannot 
exceed 1024 bytes. Therefore, in the case of the Read Selected Option, the total 
length of all selected pathnames from the scrolling list cannot exceed 1024 bytes. 
In the case of the Read Entire List option, the total length of all filenames in the 
scrolling list cannot exceed 1024 bytes. If the total length of all files to be read 
does exceed 1024 bytes, tapetool will only read those files up to the 1024 
byte maximum and will terminate the Read option with an alert message display- 
ing the last file that it attempted to read. 


If you use the OpenWindows Version 2 software after you have been running the 
OpenWindows Version 3 software, the Version 3 Calendar Manager may cause 
problems for the Version 2 Calendar Manager. To avoid this, back up your 
/usr/spool/calendar/callog.<user> file before starting the Version 
3 Calendar Manager. If you later go back to Version 2, you should restore your 
old file. 


Be careful when you mail attachments from Mailtool to people who are not using 
the OpenWindows Version 3 Environment. Their mailer will not be able to 
unbundle the attachments in the same way as Mailtool. The attachments must in 
this case be unbundled by hand by using an editor and sometimes 
uudecode(1); uudecode can easily unbundle one attachment, but the file 
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must be broken up into pieces if more than one attachment is mailed. 


Mailtool may run out of swap space if you drag-and-drop a file that is too large 
into the Mailtool Attachment window. The workaround is to increase your swap 
space. 


If the Calendar Manager is not working correctly, make sure you have run the 
install _openwin script (as root). 


If your system is installed without Sun View files or you use the -nosunview 
option to start the OpenWindows environment, you may encounter the following 
warning when you start up a Version 2 X View-based application: 


System warning: No such file or directory, extras menu file 


/usr/lib/.text_extras menu (Textsw package) 


You will not be able to use the extras menu in the text subwindow. To work 
around this problem, add the following to your .Xdefaults file: 


text.extrasMenuFilename: 


OPENWINHOME/1ib/locale/C/xview/.text_extras_menu 


where OPENWINHOME 1s the value of SOPENWINHOME. 


If selection transactions do not complete successfully (e.g., Mailtool attachments 
do not display data, or drag-and-drop operations fail), it may be because you are 
using an cight-megabyte system or a system that is too heavily loaded. This is 
caused by selection timeouts. The selection timeout value for X View-based 
applications is the time a requesting application will wait for a response from the 
selection holder. In general, the default three- second timeout is sufficient for a 
selection transaction to complete. 


If your selection transactions are failing, increase the default selection timeout to 
10 seconds by putting the following in the .Xdefaults file in your home 
directory and then restarting the OpenWindows session: 


selection.timeout: 10 
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Complete OPEN LOOK 
Mouseless Model 


Compiling an X View 
Application Statically 


Toolkit/OLIT Issues 


Enter Key on Numeric 
Keypad 


XInput Extension 


Problems When Using 
Monochrome Monitors 


The complete OPEN LOOK Mouseless Model is only enabled when 
OpenWindows.KeyboardCommands is set to FULL. Refer to the XView Pro- 
gramming Manual for information. 


If you compile an XView application statically and do not specify -lc asa 
library to link against, a compiler warning is issued: 


ld: /lib/libc.a(flsbuf.o): _fflush: multiply defined 


The workaround is to specify —1c as a library to link against. 


If you use the keypad Enter key when the NumLock key is depressed (that is, 
when the keyboard is in numeric mode), it will work as specified. If you try to 
use it when NumLock is not depressed (cursor mode), it will not work correctly. 
To eliminate this problem, add the following to the user’s defaults file for your 
application: 


Olitapplication*returnKey: <Return>, <KP_Enter> 


where Olitapplication is the name of the application. 


To make the adjustment for all applications, add the following to .Xdefaults: 


*returnKey: <Return>, <KP_ Enter> 


OLIT supports the X input extension. Sample code demonstrating its use is 
available on the SUCCESS library (token number 6186). 


Several difficulties may arise when you use a monochrome monitor: 


e FlatExclusives and FlatNonExclusives widget labels disappear 
when the inputFocusColor matches the background color. This prob- 
lem is much more likely to appear on a monochrome monitor since there are 
only two colors. 

e When you use aRectButton in mouseless mode on a monochrome moni- 


tor, you will not be able to tell if the button is selected or not. Normally, in 
2D mode you can tell if a button is selected because its border becomes bold. 
However when a Rect Button receives input focus in mouseless mode, the 
border of the button is removed, preventing you from telling what the button 
state is. 


S 
Go Sun Revision A of December 1991 


microsystems 


Setting the 
XtNconsumeEvent 
Resource ona 
ScrollingList Widget. 


Destroying Popup Widgets 


Destroying DrawArea 
Widgets 


Setting Checkbox Text Font 
Color 


No Compose Key Light with 
OLIT Applications 


Toolkit/ITNT Issues 


TNT Demos 


No NeWS or TNT with 4-bit 
Visuals 


Color Changes in Workspace 
Properties Pop-up 


Menu Repainting 


SY 
R Sun 


Chapter 10 — Known Problems 10-39 


e When you use a TextField widget on a monochrome monitor, the line 
and the arrows at the end of each line in the widget may not show up. 


If you set the XtNconsumeEvent resource ona ScrollingList widget, 
the callback will never get called. The ScrollingList does not currently 
propagate events to its ListPane child. 


If you destroy an unrealized Popup widget which contains a TextEdit widget, 
the program will die with an Xlib error. 


OLIT applications that destroy DrawArea Widgets will crash. 


Setting the font color in the checkbox widget does not have any effect. 


The Compose key will work correctly in OLIT applications, but the Compose 
LED on the keyboard will not illuminate when Compose is active. 


TNT demos, such as jed and jet, are only available on the "Advanced User 
with Demos" and "Full OpenWindows" clusters. See the OpenWindows Version 
3 Installation and Start-Up Guide for details. 


NeWS and TNT are not supported on a 4-bit visual. 


Whenever the colormap compaction utility is run it writes a file, .owcolors. 
When the server is restarted . owcolors is read to initialize the colormap. 
After the file is read, TNT colormap initialization fails. The symptom of this 
failure is that TNT applications do not respond dynamically when workspace 
colors are changed using the WorkSpace Properties pop up. 


At certain times, the SaveBehind feature of TNT menus is erroneously invali- 
dated. This invalidation causes repainting of the area under the menu when the 
menu is brought down, instead of repairing the area using the SaveBehind 
feature. 


A patch has been provided with the OpenWindows Version 3 release to minimize 
this behavior. You must copy it manually from the CD-ROM before you can install 
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it. To copy it, make sure that you are running as root and have set 
SOPENWINHOME to the location where you installed the OpenWindows 
software. Then enter the following: 


Replace /cdrom with the appropriate directory if you mounted the CD-ROM 
elsewhere. 


After you have copied the patch by hand, you may install it in one of the follow- 
ing ways: 


e Do the following, as root: 


This loads the patch into your running server, but only affects TNT applica- 
tions started after installing the patch. If you restart the server, the patch 
must be reinstalled. 


e Append SOPENWINHOME/etc/NeWS/tnt/menu_fix.ps to your 
SHOME/.user.ps file. 


This installs the patch each time your server is restarted and affects all TNT 
applications started after the server is restarted. 


ToolTalk Service Issues Due to a problem in ToolTalk 1.0, you should create dynamic message patterns 
for all psignatures and osignatures (static message patterns) listed in your ptypes 
and otypes. Register these dynamic message patterns with 
tt_pattern_register(). Donotuse tt_ptype_ declare(), which will 
automatically create and register message patterns based on the psignatures and 
osignatures in your ptypes and otypes. There is no problem using ptypes or 
otypes. Ptypes provide a start "string" for the ToolTalk service to automatically 
start your application when it’s needed. 


The static message patterns in your ptype and otypes may be used when a mes- 
sage is addressed to an otype or contains instructions to start an application or 
queue the message. If no running process matches the message, the ToolTalk ser- 
vice looks at the ptypes and otypes it has read in from the Classing Engine to 
look for a matching static message pattern. 


If you use tt_ptype_declare(), the following problem could surface. If two 
processes have declared the same ptype (using tt_ptype declare())ina 
ToolTalk session and one of the processes quits the session, the ToolTalk service 
removes the message patterns for that ptype without checking to see if another 
process has also registered that ptype. This leaves the remaining process with no 
registered message patterns (except those registered dynamically) and as a result, 
the remaining process no longer receives messages that match the patterns con- 
tained in its ptype. 
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This problem also affects processes that have different ptypes but their ptypes 
contain a pattern with the same op (operation name). When a process that has 
declared a ptype containing a pattern with the common operation name quits the 
ToolTalk session, the pattern with the common operation name is removed from 
memory. The remaining processes that declared a ptype that also contains the 
common operation name will no longer receive messages that match that particu- 
lar pattern. 


The following instructions for creating dynamic patterns that match your static 
patterns are in the form of code templates. Templates are given for ptype and 
otype definitions. In each template strings in <>’s denote variables and names in 
[]’s denote optional variables. Refer to the ToolTalk 1.0 Programmer’ s Guide 
for more information on ptype and otype syntax. 


The general form of a ptype definition is: 


ptype <ptype name> { 


<cat>: 
<scope> <op>(<argl>, ..., <argN>) => [start] 
[queue] [opnum=<opn>]; } 


Repeat the following template for each signature listed in the ptype definition: 
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declare ptype_ signature () 


{ 


Tt_pattern P} 


p = tt_pattern_create(); 

if (<cat> == "handle") { 
tt_pattern_category_set(p, TT_HANDLE) ; 

} else if (<cat> == "observer") { 
tt_pattern_category set(p, TT_OBSERVE) ; 

} 

if (<scope> == "session") { 
tt_pattern_scope_add(p, TT SESSION); 

} else if (<scope> == "file") { 
tt_pattern_scope_add(p, TT_FILE); 

} else if (<scope> == "both") { 
tt_pattern_scope_add(p, TT_BOTH); 

} else if (<scope> == "file in session") 
tt_pattern_scope_add(p, 
TT _FILE_IN_SESSION) ; 

} 

tt_pattern_op_add(p, <op>); 

if (opnum is listed) { 
tt_pattern_opnum_add(p, <opn>); 

} 

tt_pattern_address_add(p, TTI_PROCEDURE) ; 

if (start is listed) { 
tt_pattern_disposition_add(p, 

TT START) ; 

} 

if (queue is listed) { 
tt_pattern disposition _add(p, 

TT_QUEUE) ; 

} 

/* optionally, you can add a callback since 

this is a dynamic pattern*/ 


tt_pattern_register(p); 


This example shows how to create a dynamic pattern for the third message pat- 
tern listed in Sun_EditDemo’s ptype. Sun_EditDemo is a sample program stored 
in SOPENWINHOME/share/src/tooltalk/. The ptype is listed in the 
edit .type file in this directory. 
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pattern corresponding to ptype signature: 


file _in_session Sun_EditDemo_save_as(in 


string new_filename) 
=> opnum=SUN_EDITDEMO_SAVE_AS; 
es, 
declare _ptype_signature () 
{ 
Tt_pattern p3; 


p3 = tt_pattern_create(); 
tt_pattern_category set(p3, TTI_HANDLE); 
tt_pattern_scope_add(p3, 

TT FILE_IN SESSION); 

tt_pattern_op_ add(p3, 
"Sun_EditDemo_save_as"); 
tt_pattern_opnum_add(p3, 
SUN_EDITDEMO_SAVE_AS) ; 
tt_pattern_address_add(p3, TTI_PROCEDURE) ; 
tt_pattern_arg_add(p3, TT_IN, "string", 
(char *)0); 


tt_pattern_register(p3); 


The otype message pattern definition is similar to the ptype definition. Use this 
template to provide otype message patterns. 


otype <otype_name> { 
<cat>: 
<op>(<argl>, ..., <argN>) => <ptid> 


[<scope>] [start] [queue] [opnum=<opn>]; }; 


Repeat the following for each signature listed in the otype. 
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declare _otype signature () 
{ 
Tt_pattern Pp; 
p = tt_pattern_create(); 
if (<cat> == "handle") { 
tt_pattern_category set(p, TTI_HANDLE) ; 
} else if (<cat> == "observer") { 
tt_pattern_ category set(p, TTI OBSERVE) ; 
} 


if (<scope> == "session") { 
tt_pattern_ scope add(p, TT_SESSION) ; 

} else if (<scope> == "file") { 
tt_pattern_scope_add(p, TT_FILE); 

} else if (<scope> == "both") { 
tt_pattern_scope_add(p, TT_BOTH); 

} else if (<scope> == "file in session") { 


tt_pattern_scope_add(p, 
TT FILE_IN SESSION); 
} 
tt_pattern_op_ add(p, <op>); 
if (opnum is listed) { 
tt_pattern_opnum_add(p, <opn>); 
} 
tt_pattern_otype_add(p, <otype_name>) 
tt_pattern_address add(p, TT_OTYPE); 
tt_pattern_address add(p, TT_OBJECT); 
if (start is listed) { 
tt_pattern_disposition_add(p, 
TT START) ; 
} 
if (queue is listed) { 
tt_pattern_disposition_add(p, 
TT QUEUE) ; 
} 
/* optionally, you can add a callback since 
this is a dynamic pattern*/ 


tt_pattern_register (p); 


This example shows how to create a dynamic pattern for the message pattern 
listed in Sun_EditDemo’s otype. The otype is listed in the edit .t ype file in 
the SOPENWINHOME/share/src/tooltalk directory. 
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pattern corresponding to otype signature: 
hilite_obj(in string objid) 
=> Sun _EditDemo file_in_ session start 
* opnum=SUN_EDITDEMO_HILITE_OBJ; 
ey 
declare otype_signature () 
{ 
Tt_pattern po; 


p5 = tt_pattern_create(); 

tt_pattern category set(p5, TT HANDLE) ; 
tt_pattern_scope_add(p5, 

TT FILE IN SESSION); 
tt_pattern_op_add(p5, "hilite_obj"); 
tt_pattern_opnum_add(p5, 
SUN_EDITDEMO_HILITE_OBJ) ; 
tt_pattern_otype_add(p5, 
"Sun_EditDemo_object") ; 
tt_pattern_address add(p5, TT_OTYPE); 
tt_pattern_address add(p5, TT_OBJECT); 
tt_pattern_disposition_add(p5, TI_START); 
tt_pattern_arg_add(p5, TTI_IN, "string", 
(char *)0); 


tt_pattern_register(p5); 


If arguments are listed in either the ptype or otype signature, use this template to 
add them to the pattern: 


Case |: 


<op> () 


This case specifies that argument matching is not required for this signature so no 
action needs to be taken. 


Case 2: 


<op> (void) 


This case specifies that this signature takes no arguments. No action is required. 
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Case 3: 


<op> (<model> <typel> <namel>, ...,<modeN> 
<typeN> <nameN>) 
if (<mode> == "in") { 
tt_pattern_arg_ add(p, TT_IN, <type>, (char 
*)0); 
else if (<mode> == "out") { 


tt_pattern_arg_ add(p, TT_OUT, <type>, (char 
*)0); 

else if (<mode> == "inout") { 

tt_pattern_arg add(p, TT_INOUT, <type>, (char 
*)0); 


In this case, you need to add arguments to the dynamic pattern. For an example 
of this, see the Sun_EditDemo ptype example. 


Supplemental The following sections are supplements to the OpenWindows Version 3 docu- 
Documentation mentation. 

NeWS Programming: NeWS The correct definition of the reshapecanvas operator differs from the 
Operators definitions given in the NeWS 3.0 Programmer’ s Guide and in the OpenWindows 


Version 3 Release Manual. Most of the changes occur in the paragraphs regard- 
ing the X Shape Extension. The following is the correct definition for 
reshapecanvas: 


canvas reshapecanvas - 
canvas path reshapecanvas — 


canvas borderwidth reshapecanvas — 
canvas path borderwidth reshapecanvas - 


If a canvas argument alone is specified, this operator sets canvas’s shape to be 
the same as the current path, and sets canvas’s default coordinate system to be 
the same as the current coordinate system. This results in a new canvas transfor- 
mation matrix. If the current path is empty, with canvas as the only argument, 
this operator has no effect. 


If canvas is the current canvas, an implicit initmatrix and initclip are 
performed. initmatrix sets the current transformation matrix to be the same 
as the new canvas’s transformation matrix. initclip sets the current context 
clip path to be the same as the new canvas’s shape. An implicit newpath is 
always performed to clear the current path. 
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If the current path is non-rectangular and the only argument, canvas, is an X can- 
vas, canvas’s X Shape Extension is activated by setting canvas’s client bounding 
region to be the same as the current path and canvas’s default bounding region to 
be the same as the bounding box of the current path. Canvass effective bounding 
and/or clip regions are recomputed properly. 


Canvas’s default bounding region is the rectangular area that covers both 
canvas’s client drawable interior and its border (as described in the X core proto- 
col). Canvas’s default clip region is canvas’s default bounding region without the 
border. Canvas’s client bounding region 1s the client-defined bounding region, 
which can be non-rectangular. Canvas’s client clip region is the client-defined 
clip region, which can be non- rectangular. Canvas’s effective bounding region is 
the intersection of canvas’s default bounding region and client bounding region. 
Canvas’s effective clip region is the intersection of canvas’s effective bounding 
region, default clip region, and client clip region. These regions maintain con- 
stant distances from canvas’s X default origin, which is the upper left corner of 
canvas’s default clip region. See the X/1 Non-Rectangular Window Shape 
Extension (MIT X Consortium Standard Version 1.0, Copyright 1989 by the 
Massachusetts Institute of Technology) for more information. 


If the current path is rectangular and the only argument (canvas) is an X canvas, 
then canvas’s default bounding region is set to be the same as the current path. In 
this case, if canvas’s X Shape Extension is activated (i.e. if canvas has a client 
bounding region and or a client clip region), then canvas’s effective bounding 
and or clip regions are recomputed properly. 


The path and or borderwidth arguments can be used only if canvas is an X can- 
vas, otherwise this operator results in a typecheck error. 


A non-empty current path and path activate canvas’s X Shape Extension (if it is 
not activated already) by setting canvas’s client bounding region to be the same 
as path. If the current canvas is different from the context canvas used when 
forming path, then path is pre-translated such that its distance to the upper left 
comer of the current canvas’s default bounding region is the same as its previous 
distance to the upper left corner of its context canvas default bounding region. A 
non-empty current path and empty path result in the removal of canvas’s client 
bounding restriction. Canvas’s effective bounding and/or clip regions are recom- 
puted properly. 


An empty current path and path activate canvas’s X Shape Extension (if it is not 
activated already) by setting canvas’s client clip region to be the same as path. If 
the current canvas is different from the context canvas used when forming path, 
then path is pre-translated such that its distance to the upper left corner of the 
current canvas’s default bounding region is the same as its previous distance to 
the upper left corner of its context canvas default bounding region. An empty 
current path and an empty path result in canvas’s client clip restriction being 
removed. Canvas’s effective clip region is recomputed properly. 


borderwidth resets canvas’s default clip region and recomputes canvas’s effec- 
tive clip region properly. 
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TNT: Drag-and-Drop 
Changes 


ClassSelection 


SY 
& 


The following sections contain changes to ClassSelection, and ClassTextCanvas 
that didn’t get included in the NeWS Toolkit Reference Manual. In addition, a 
new Class, ClassTextSelection, is introduced below. 


ClassSelection has a new variable and a new method that are used to implement 
drag and drop animation. 


/DragCursorType (Variable) 


Determines how /setdragimage (below) combines the drag-and-drop pointer 
glyphs with an application-specific image. The legal values are: 


/SourceImage: Center the application image around the pointer glyph 
/Boxed: Place the application image in the ‘flying punchcard’ box. /Boxed is the 
default. 


/SourceImage drags should be used when dragging a whole object, e.g., an entire 
file. /Boxed drags should be used when dragging a portion of a larger object (e.g., 
some text from a file, one object from a drawing). 


cursorimage maskimage /setdragimage - 


Builds a drag-and-drop pointer using cursorimage and maskimage. cursorimage 
and maskimage can only be 1-bit deep canvases. Both cursorimage and maskim- 
age must be given, but they can be the same canvas. The value of /DragCursor- 
Type (above) determines how the application-specific image and the drag-and- 
drop pointer glyphs are combined. /setdragimage is typically called from the 
/DragStart method. 


The Toolkit provides two ways to set the drag-and-drop pointers for an applica- 
tion selection: 


e Use /DragCursorType and /setdragimage to combine an application- 
specific image with the default pointer glyphs. ClassTextCanvas uses this 
combination to provide the flying punchcard text drag cursor. This is also the 
easiest way to merge application-specific images with the OPEN LOOK drag- 
and-drop pointer glyphs. 


e Override the drag-and-drop pointer class variables in your ClassCanvas sub- 
class. There are eight pointer variables that you can override: /InsertMo- 
veCursor, /InsertCopyCursor, /ReplaceMoveCursor, /ReplaceCopyCur- 
sor, /NeutralMoveCursor, /NeutralCopyCursor, /InvalidMoveCursor, 
and the /InvalidCopyCursor. Overriding the canvas variables is a good 
mechanism if your drag-and-drop cursors aren’t likely to change from 
instance to instance. OpenWindows has an OLcursor font that contains pre- 
defined cursors that cover several of the most common source image cases. 


For more information on drag-and-drop pointers see the OpenWindows Version 3 
Desktop Integration Guide. 
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ClassTextSelection 


ClassTextCanvas 


ClassTextSelection subclasses ClassSelection to set defaults and provide 
definitions for several ClassSelection subclass responsibility methods. 
ClassTextSelection does the following: 


e Sets the default /DragCursorType to be /Boxed 
e Sets the default cursors to be empty ‘flying punchcard’ cursors. 


e Creates the /CanRenderAs dictionary with /ContentsAscii, /Con- 
tentsPostScript, and /SelectionObjsize as the keys. The value for each key is 
a proc that obtains the requested value. The proc executes during a call to 
/SingleRequest. 


e Creates a dictionary named /ActionRequests. /ActionRequests is similar to 
/CanRenderAs but contains those requests with side-effects instead of 
values. Default requests are /DeleteContents and /Canvas. The /Canvas key 
does not denote an action, but it can’t go into /CanRenderAs because of the 
possibility of creating a sticky window if the selection is copied to the clip- 
board. 


e Overrides /AllRequests to return a dict that combines /CanRenderAs and 
/ActionRequests. 


e Overrides /Deselect to forward /Deselect to the Holder of the selection. 


e Overrides /SingleRequest to expect the value from /CanRenderAs or 
/AllRequests to be the proc to execute to obtain the value. 


ClassTextCanvas has changed to reflect the new drag-and-drop implementation. 
ClassTextCanvas subclasses ClassCanvas to provide assistance for clients whose 
selections are character strings and who want use the standard OPEN LOOK 
semantics for dragging and dropping text. ClassTextCanvas is Selectable, sets 
/SelectableType to be /Text, and defines /DragStart. You still must provide the 
definitions for the other selectable subclass responsibility methods in ClassCan- 
vas. 


Creation 
parentcanvas /new instance 
Creates a text canvas. 


Drag Methods 
event selection /DragStart - 
Creates a text drag cursor that contains part of the selected text. 


selection /CurrentText string 

Obtains the text to display in the overlay canvas. Subclassers will generally wish 
to override the /CurrentText method for greater efficiency (the default uses the 
normal /query mechanism whereas individual subclasses can usually obtain the 
text by more direct methods). 
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Running OpenWindows via 
xdm 


xdm Files 


xdm(1), the X display manager, is used to control a collection of both local and 
remote displays, and is typically started by root. When OpenWindows runs via 
xdm, you see a login window on the screen, welcoming you to the system and 
asking for your username and UNIX password. The login capability is very rudi- 
mentary, in that a user’s configuration files, such as . login and .cshrc or 
.profile are not executed. 


After you successfully log in, xdm starts up your X environment, typically by 
reading the executable file named .xinitxrc in your home directory, and runs 
an Xsession. On exiting from the window system, the window server is restarted 
by the xdm daemon. 


A configuration file is usually provided to xdm at start-up. This file is used for 
initial xdm set-up. This file also contains pointers to other shell scripts used in by 
xdm. xdm is typically started by root. The user environment for root must be 
set-up correctly, as follows: 


A typical command line, where the configuration file is provided to xdm at start- 
up is as follows: 


By default, xdm looks in /usr/openwin/1ib/xdm to find the configuration 
files it requires. The configuration file and other shell scripts used by xdm are in 
SOPENWINHOME/1ib/xdm. It is suggested that you start with this set of files 
if you wish to change the behavior of xdm. From its original X11R4 version, 
xdm has been modified slightly to allow it to work more efficiently with the 
OpenWindows X11/NeWS server. When started by root, xdm executes a window 
server which is listed in the file, Xservers. Once the server has initialized 
itself, the login window through which a user may log into the system displays. 


The following are some of the files used in conjunction with xdm: 


e SOPENWINHOME/1lib/xdm/xdm-config 
This file is used by xdm; see the man page for more information. 


e SOPENWINHOME/1lib/xdm/Xservers 
This file lists which server to run and whether to run local or remote: 


:0 Local local SOPENWINHOME/1ib/xdm/StartOw :0 


e SOPENWINHOME/1lib/xdm/StartOw 
This file contains the shell script used to pass the correct arguments to the 
OpenWindows server. 


e SOPENWINHOME/1ib/xdm/Xsession 
This file runs as the client for the display manager. It attempts to run a per- 
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user .Xinitrc. It also forces the window server to change its userid to 
that of the new user. 
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Part 5 — Appendixes 


Part 5 consists of the following appendixes: 


Appendix A, “Documents Available for Use with SunOS 4.1.2” 
Appendix B, “Addendum to Writing Device Drivers” 

Appendix C, “Sundiag version 2.3 for SunOS 4.1.2” 

Appendix D, “X/Open Conformance Statement (XCS-QUE-3.106)” 


Part 5 — Appendixes — Continued 


Books: User’s Guides 


Binder: System and Network 
Administration 


Books: OpenWindows End User 
Manuals 


Binders: SunOS Reference 
Manual (3 Volumes) 


S 


Documents Available for Use with 
SunOS 4.1.2 


An extensive collection of software manuals is made available for use with 
SunOS 4.1.2. The manuals are shipped in binders that may contain one or more 
documents. The following describes the contents of the binders following the 
general order of use. This release manual and Installing SunOS System Software 
were described in Chapter 1, and are not listed here. 


These brief manuals are easy to read, written for the user with little or no UNIX 
experience. Getting Started is for those new to the Sun environment. Other titles 
are Doing More with SunOS, Basic Troubleshooting, SunView User’s Guide, and 
Customizing Your Environment. The SunDiag User’s Guide is in the same box, 
but is written for users who will be testing memory, drives, boards, and board- 
level devices with SunDiag. 


The System and Network Administration manual is written for system administra- 
tors, but is a valuable resource for all SunOS users. It deals with adding 
hardware, disk maintenance, networking and electronic mail service, and 
advanced UNIX administration. 


This is a set of four guides for the user who is new to OpenWindows: 


OpenWindows Version 2 User’s Guide 
DeskSet Environment Reference Guide 
OpenWindows Version 2 Release Notes 
OpenWindows Version 2 Installation & Start-Up Guide 


This set of binders contains the SunOS version of the Berkeley UNIX man pages, 
alphabetically arranged descriptions of commands, functions and other aspects of 
SunOS 4.1.* Numbered tabs divide the Reference Manual into a range of topics, 
as listed below: 


1. User Commands 


* New man pages for SunOS 4.1.2 are included in the release box. 
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Binder: Global Index 


Binder: SunOS Documentation 
Tools 


Binder: Programmer’s Guides 


Binder: Programmer’s 


Overview Utilities and Libraries 


Binder: Network Programming 
Guide 


System calls and error numbers 

User-level library functions 

Devices, drivers, protocols and network interfaces 
File formats used or read by various programs 
Games and demos 

Public files, tables and TROFF macros 

System maintenance and operations commands 


COO a ee 


Provides an index to SunOS 4.1 software documentation. It is not updated for 
SunOS 4.1.1, SunOS 4.1.1 Rev B, or SunOS 4.1.2. 


Editing Text Files covers the editors vi, ex, ed, and sed. Formatting Documents 
explains special formatting macros that work with TROFF such as refer, index- 
ing, table formatting and equation setting. Using TROFF and NROFF explains the 
use of those text processing utilities. 


This group of manuals focuses on programming within the Sun environment, for 
both systems and applications level interests. 


C Programmer’s Guide describes how to write C programs that interface with 
SunOS. Assembly Language Reference Manual for Sun-3 and Assembly 
Language Reference Manual for Sun-4 covers syntax and usage of the assembler 
for some of the microprocessors used in Sun workstations and servers. A RISC 
Tutorial looks at the aspects of RISC and open systems architectures as they per- 
tain to SPARC architecture. Porting Software to SPARC Systems briefly describes 
machine level SPARC architecture, and porting C, FORTRAN, and Pascal pro- 
grams to a SPARC system. The Debugging Tools Manual describes the 
debuggers dbx, dbxtool, and adb for experienced programmers. 


The System Services Overview contains details of various specialized aspects of 
SunOS operating system, including internationalization, security features, net- 
working, and UNIX standards compatibility. Programming Utilities and 
Libraries is written primarily for applications programmers to provide an over- 
view of the Sun environment, and the system facilities, utilities, and libraries 
supported. 


The Network Programming Guide provides an overview of NFS, pipes, sockets, 
network commands, Sun online database service, and network managers and 
monitors. 
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Binder: Writing Device Writing Device Drivers is a guide to adding drivers for new hardware devices to 

Drivers/STREAMS Programming the SunOS kernel. The STREAMS Programming manual covers the theory of 
STREAMS programming, the SunOS-specific implementation, and catalogs 
STREAMS functions and data structures. 


Binder: SunView SunView 1 Programmer’s Guide is written for applications programmers to sup- 

Programmer’s Guide port interactive, graphics-based applications running within windows. The Sun- 
View 1.80 Update Appendix updates the SunView I Programmer’s Guide with 
the latest information. 


Binder: SunView 1 System The SunView I System Programmer’s Guide describes how SunView works from 

Programmer’s Guide the inside, and how to structure applications. The Pixrect Reference Manual 
describes the Pixrect graphics library routines that manipulate arrays of pixel 
values, and RasterOps used by applications programs to manipulate bit-mapped 
displays. 
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Addendum to Writing Device Drivers 


This addendum has two parts: 
e Sun-4m Device Driver Developer Notes 


e SunOS 4.1.1 Changes 


Due to architectural differences between 600MP and previous Sun machines, 
there are few key points that device driver developers must be aware of: 


e 600MP supports both VME and SBus. There is also an /O cache (I0C) (which 
actually behaves more like a write buffer) on the VME bus interface. 


e  600MP has a separated IOMMU which is capable of doing "coherent DVMA" 
with respect to the CPU caches. 


With a separated IOMMU, DVMA mappings are now independent of the host 
SRMMU mappings. This means that by default a DVMA address should be con- 
sidered as only valid from the point of view of devices that will be doing DVMA, 
and it should be considered invalid from the point of view of a CPU (and your 
driver, since it runs on a CPU). Similarly, a host SRMMU virtual address should 
not be used by a device to perform DVMA. 


As a result of the these new features, 600MP supports at least 16MB (also 
default) of DVMA space. This DVMA space is divided into 4 regions (maps): 


vme24map: despite its name, a vme32 device can use this map too. This 
is the default map for all VME devices. This map is about 1MB. 


vme32map: only vme32 devices can use this map. This map is about 6MB. 
sbusmap: default map for SBus devices. This map is about 1 MB. 
bigsbusmap: an optional map for SBus devices. This map is about 8MB. 
NOTE: although there are now four maps, for compatibility reasons, a VME 
driver should still use mb_hd.mh_map as an argument to the mb_XXxX routines. 
Similarly, SBus devices should use dvmamap to interface with the mb_XXX rou- 


tines. See “Performance Tuning” below for information about using the larger 
vme32map and bigsbusmap. 
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Compatibility 


G 
< 


Most drivers can probably run on a 600MP series machine without recompila- 
tion, but some may require some modifications. The following is a list of points 
to consider to determine if a existing driver is portable to a 600MP series 
machine: 


Does the driver use only standard driver supporting routines provided by the 
kernel, such as mb_mapalloc/mb_mapfree (and their mb_XXX varia- 
tions) to manage DVMA mappings? 


Note: segkmem_XXX and hat__XXxX are not considered as standard driver 
supporting routines. 


If your driver uses non-standard routines to set up DVMA mappings, it most 
likely will NOT work on a 600MP series machine (since mb_XXX routines 
are the only routines that set up DVMA mappings on the IOMMU) These 
drivers MUST be converted over to use the standard mb_XxXxX routines if 
they are to be portable. 


Does the driver use DVMA[some_offset] to reference/modify data inside the 
DVMA data transfer buffers? 


If the answer is yes to this question, then: 


e if itis a VME device, it will run as is. However, it is advised that the driver 
should use bp_mapin() and bp_mapout() routines for better portability. 


e if it is an SBus device, you need to convert it to use 
bp_mapin() /bp_mapout(). Otherwise, the driver will pick up random 
values. 


This is due to the fact that DVMA addresses are now independent of the host 
SRMMU virtual address. For compatibility reasons, the DVMA mappings in 
vme24map (default map for vme devices) is set up such that DVMA[] refer- 
ence would still work. However, the same thing can not be done on the SBus 
maps, so it is no longer compatable with other Sun machines. 


Does your VME device run with IOC off? 


IOC only works on VME devices. IOC is turned on/off, flushed automatically 
by the mb_mapalloc() /mb_mapfree(). Currently, there is no easy way 
for a driver to disable IOC. 


Does the driver use the io0c_f1lush() macro to flush IOC? 


If yes, the driver needs to be recompiled on a SPARCsystem 600MP series 
machine; the binary will not be portable to other machines. 


Other than the points listed above, a driver should be written exactly the same 
way as if it were written for other machines. A driver written for 600MP series 
machines should work for the other machines but not necessarily vice versa since 
the rules for 600MP are more restrictive. The only exception to this rule is if your 
driver uses non-default, large DVMA maps which are not supported on other 
machines (see “Performance Tuning’’). 
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Interrupts 


Write Buffers 


Performance Tuning 


Hardware interrupt levels for Sun-4m are different than for Sun-4 or Sun-4c. 
Refer to the Sun-4m System Architecture document for details. 


The Sun-4m mapping of SBus and VMEbus interrupt levels to SPARC interrupt 
request level (IRL) is different from previous Sun-4 and Sun-4c architectures. A 
device which interrupts at SBus level x, which is mapped by the onboard inter- 
rupt logic to SPARC IRL y on Sun-4 or Sun-4c, will now be mapped to SPARC 
IRL z on Sun-4m and z may be greater than y. This may introduce bugs which 
typically manifest themselves as corrupted data structures leading to kernel 
crashes. 


For Sun-4m, device drivers should not make Networking or STREAMS framework 
function calls while operating at SPARC IRL levels higher than IRL 7 (spl imp) 
for networking, or IRL 10 (Splstr) for STREAMS. Doing so circumvents the 
interrupt masking being done by the networking and STREAMS subsystems them- 
selves and risks data structure corruption. Device drivers should do minimal pro- 
cessing at high interrupt levels and schedule a software interrupt for further inter- 
rupt processing, including interacting with other portions of the kernel. 


For Sun-4m, it is OK to call networking and mbuf utility routines while servicing 
a device interrupt at VME and SBus levels 4 and below. It is OK to call STREAMS 
utility routines at VME and SBus levels 5 and below. 


In general, device drivers which support multiple devices which interrupt at more 
than one hardware interrupt level must take precautions to service only those 
interrupts at the "current" interrupt priority level (via sp1toip1Q ) in order to 
avoid race conditions which result in the error message “Level XXX BBB inter- 
rupt not serviced.” 


Write buffers are used to accelerate writes and reduce bus occupancy for better 
overall system performance. Write buffers exist both for programmed I/O and 
DVMA activity. Use of the mb_xxx() routines guarantees correct operation. All 
write buffers in the Sun-4m architecture follow these rules: 


e Once a write buffer has accepted a write, it must either guarantee that the 
write can occur without error, or the write buffer is responsible for reporting 
those errors, 


e Write buffers are read-stall; that is, after a write buffer has accepted a write, 
any subsequent access to that device must wait for the write operation to 
complete (order is maintained). Although write buffers are not visible to 
device drivers, their effect may be. While order is maintained, the relative 
timing of writes to the device may be significantly different from the issuing 
(CPU) timing. 


To optimize the performance for drivers running on 600MP series machines, 
drivers can do the following: 
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vme32 devices 


SBus Devices 


IOMMU Bypass Mode 


SBus Slot Configuration 
Register 


Open Boot PROM 


If the driver does not peek inside the DVMA data buffers without 

bp_mapin() /bp_mapout(), it may set the MDR_VME32 flag to use the much 
larger vme3 2map, instead of the smaller default vme2 4map. If the DVMA | 
request size is not larger than 1 MB, adding this flag should not cause problems in 
terms of portability. It will be simply ignored by machines that do not have this 
map. 


SBus devices can set the MDR_BIGSBUSMAP flag to use the big 8MB map. If it 
uses the big map, it must NOT add the DVMA base to form the DVMA address 
passed to the device. Mb_mapalloc() already returns a correct "ready to use" 
DVMA address. Usage of this map makes the driver NON-portable. 


NOTE: driver should not use vme3 2map or bigsbusmap as arguments to the 
ml__XXX routines. Instead, use flags as described. 


If a driver uses IOMMU bypass mode, it will be responsible for its own DVMA 
mappings. The standard DVMA supporting routines described above will not be 
useful for them. 


There is an SBus slot configuration register for each SBus slot in the system. 
Each SBus slot configuration register provides information about the slave device 
in that slot (slave support for 64-, 32-, 16-, and 8-byte bursts), and is also used for 
IOMMU bypass management for that slot. The boot code is expected to configure 
the slot based upon FCodes associated with the SBus device. Refer to the Open 
Boot PROM V2 Reference Manual. Failure of the device firmware FCode to sup- 
port this property will result in less than optimal slave access performance for the 
device as only 4-byte word sized slave transfers will be used. 


SPARCsystem 600MP is released with version 2 of the open boot PROM 
firmware. Refer to the OBP V2 Reference Manual for details. 
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B.2. SunOS 4.1.1 Changes This appendix is an addendum to Writing Device Drivers for Sun Workstations; it 
replaces a similar document which was distributed with the SunOS 4.1 PSR 
A Release Manual. It contains important information if you are planning to 
implement an I/O device driver for a DVMA device that runs on a machine with an 
VO Cache (10C). Machines with an I/O cache include the Sun3/4X0 series (Sun- 
3/460, Sun-3/470, Sun-3/480) and the SPARCsystem 4X0 series (SPARCsta- 
tion470, SPARCserver 470, SPARCserver 490). 


The IOC provides a Write-Back buffer for VME I/O devices capable of initiating 
accesses to Main Memory. On Sun machines, I/O devices use virtual addresses 
for memory access. Direct Memory Access using virtual addresses is referred to 
as DVMA, and devices capable of initiating DVMA are called DVMA devices. — 


The SPARCsystem 4X0 IOC consists of 128 sets of 32-byte-wide data buffers. 
The Sun-3/4X0 IOC consists of 128 sets of 16-byte-wide data data buffers. 
Except for this difference, the two caches are identical. The following descrip- 
tion will assume the SPARCsystem 4X0 IOC. 


Each data buffer corresponds to an 8K page, so that serial transfers through a par- 
ticular DVMA page are buffered into 32-byte blocks on their way to or from 
memory. For example, aDVMA write to memory will use the same IOC buffer 
repeatedly as it serially transfers a page: each 32-byte block on the page is 
flushed to memory by the next 32-byte block on the same page. At the end of 
each such DVMA write there will be one line in the IOC for each page of the 
transfer that will contain valid data that has yet to be written to memory. 


The IOC is designed to buffer data into blocks to make long serial transfers more 
efficient. When an IOC line is flushed, all 32 bytes are flushed, even if some 
bytes of the line were not modified. Despite its name, the IOC is really a buffer. 
When transferring from a device to memory the cache line is not filled from 
main memory before the line is updated with data from the device. This makes 
using the IOC appropriate for buffering data transfers, but inappropriate for 
buffering I/O control block information which is shared between the device and 
the CPU. 


Drivers allocate and release DVMA using mb routines described in the Writing 
Device Drivers manual. The kernel mb routines generally account for the pres- 
ence of the IOC in ways that will be transparent to the driver. This mechanism is 
detailed here so an implementer can decide if it is suitable for a particular driver. 


The kernel mb routines enable the Sun3/4X0 and SPARCsystem 4X0 10Cs for a 
particular buffer using the criteria shown below. 


1f (bp->b_flags & B_READ) { 
if ((((u_int)bp->b_un.b_addr & IOC_LINEMASK) == 0) && 
((bp->b_bcount & IOC_LINEMASK) 
Seb. 10c = 1+ 


else /* misaligned */ 
set 10c-.= 0; 
} else /* B WRITE */ 
set .100 = 14 
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Header File Inclusion 


If the starting address of the transfer is on an I/O cache line boundary, i.e., the 
address is a multiple of the constant Ioc_LINES1ZE and the length is also a multi- 
ple of toc_LINES12ZE, the IOC is used. Note that all writes are I/O cached as writes 
correspond to reads by DVMA devices, which entail no flushes and have no align- 
ment requirements (extra bytes may be loaded from memory into the IOC, but the 
DVMA device gets only bytes from the addresses it requests from the IOC and 
there is no chance for corruption of data). 


Upon release of the /O cached DVMA space the kernel mb routines will flush any 
remaining data left in the IOC. This means that a driver for a device that performs 
DVMA in a serial fashion to aligned buffers will automatically make use of the 
IOC without requiring any code changes. 


There are some special cases: 


e What if I want a driver to use the IOC even though transfers aren’t properly 
aligned? 


In some cases, for instance DVMA to a buffer in user space, the alignment of 
the buffer into which data is received can’t be changed and you can not force 
the IOC to be used. In other cases, for instance DVMA to a buffer managed by 
the driver itself, the buffer can be appropriately manipulated so the criteria 
for use of the IOC is met. This is generally done by allocating 
IOC_LINESIZE-1 more bytes of DVMA than needed and rounding up the 
starting address to be aligned with toc_LINEsizeE. Also the size of the 
DVMA requested is rounded up to I0C_LINES1ZE even though the amount 
actually DVMA’d may be less. 


e What if I don’t want the IOC to be used? 


The I/O cache can be turned off for a DVMA transfer by making sure the 
pg_ioc bit in a DVMA page’s Page Table Entry (PTE) is set to zero. This 
should be done after DVMA space is allocated with the kernel mb routines but 
before any DVMA has occurred. The pg_ioc bit should be cleared for each 
page of DVMA involved in a transfer. 


Note that on a sun3x, this is the pte_iocache bit. 


e What if DVMA space is reused without releasing and reallocating it with the 
kernel mb routines? 


In this case either the transfer can be set up so the IOC is not used or the IOC 
can be manually flushed at whatever points are necessary to insure all data 
has reached memory. Flushing the I/O cache is accomplished with use of the 
ioc_flush() macro. The argument to ioc_flush() is the page offset 
into DVMA for the transfer. If the transfer spans more than one page then 
ioc_flush() will need to be called for each page. 


Drivers that use either the Ioc_LINESIZE constant or the ioc_flush() macro 
should include the machine/iocache.h header file. Proper inclusion is 
shown in the code fragment example below. 
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Manual IOC Flush Example In the following code fragment example, the IOC is being manually flushed for a 
range of DVMA addresses following a transfer. dvma_addr is the byte offset 
into DVMA for the transfer. dvma_count is the number of bytes the device 
transferred. 


#ifdef IOC 
#include <machine/iocache.h> 
#endif IOC 


#ifdef I0c 
if (ioc) { 
end_addr = dvma_addr + dvma_count; 


for (addr = dvma_addr; addr < end_addr; addr += MMU_PAGESIZE) { 
linenum = (addr >> MMU_PAGESHIFT) & (IOC_CACHE_LINES - 1); 
ioc_flush(linenum) ; 


} 
} 
#endif IOC 


Changes Since Earlier As of SunOS 4.1 and SunOS 4.1 PSR A, the code for managing the Sun-3/470 

Releases IOC and the SPARCsystem 4X0 IOC was inconsistent. In SunOS 4.1.1, Sun3x 
IOC management was changed to be compatible with Sun4 IoC management. 
This means that drivers compiled to use the SunOS 4.1 B_Tocacus flag to use the 
Sun3x IOC will not compile under 4.1.1. 
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Sundiag version 2.3 for SunOS 4.1.2 


The Sundiag diagnostic program, version 2.3, is shipped with SunOS 4.1.2. A 
brief description of the version 2.3 enhancements follows; see the Sundiag 2.3 
User’s Guide - SunOS 4.1.2 (Part Number 800-6020-10) for details. 


NOTE: Sundiag currently does not run with the OpenWindows window inter- 
face. If you are running OpenWindows, exit the window system before starting 
Sundiag. Sundiag will work with Sunview windows. 


The Sundiag diagnostics program includes a variety of new tests and features for 
SunOS 4.1.2. Tests for Sun’s new hardware include the following: 


e Miulti-Processing CPUs (details below) 
e Graphics Tower 

e SunVideoPix 

e Sunlink HSI 

e DRI boards 

e Serial Parallel Controller 

e  Prestoserve 

e SBus Printer cards 

e cgl2 (GS) Graphics Accelerator Board 


The following existing tests have been enhanced: 


e kmem 
e  nettest 
e  =rawtest 
e = fstest 

e = sunlink 


The following options have been added to the Sundiag program: 


-w Writes the system hardware configuration to 
the /usr/adm/sundiaglog/sundiag.conf file. 
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-b Allows you to run Sundiag in batch mode. In order to use this option, 
you must first create abatch_file in 
/usr/diag/sundiaglog/configs before using Sundiag. 

The batch_file must use the following format: 


#option file runtime delay_before_loading_next_option_file (min.) 


optfilel 
opt file2 
optfilel 
optfile3 


optfilel and opt file2 are files containing Sundiag tests. They will 
run for the times specified (in minutes) in the runtime column. Files with a 
runtime of 0 display the final status of tests that have already run. This 
feature can be used to give the status of of some or all of the option files in 
the options_file. 


The delay_before_loading_next_option_file is required to 
ensure that all tests have been stopped before the next option file is loaded. 


The settings in the Sundiag Options Menu override the settings in the batch 
files. Use larger values in the Options Menu when using batch files and 
avoid using the single pass values. 


C.1. Sundiag for the The new Sundiag multi-processor test, mpt est, verifies the functionality of 
Multiprocessing Chip Sun’s multi-processing CPUs. There are four test Options to mptest: 
Lock/Unlock, Data I/O, FPU Consistency, and Cache Consistency. As with 
other Sundiag tests, you can specify options in either of two ways — from the 
SunView Sundiag window interface or with command-line arguments. 


Running Sundiag From Sundiag automatically probes for multiprocessing CPUs when it is brought up. 

Window Interface If a multiprocessing CPU is found, mptest is displayed as an available test in 
the Sundiag SunView window. Next to the mptest entry is an Options button. 
If that button is selected with the Left mouse button, the following Option Menu 
appears: 
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Figure C-1 = mptest Option Menu 


Multi-precessors 
Configurations: 
# of processors: 4 
Processor 0 © enable 
Processor 1 © enable 
Processor 2 © enable 
Processor 3 © enable 


Sub-tests: None 


Options: 
Lock/Unlock: ~ enable 
Data I/O: ~ enable 
FPU Check: ~ enable 


Cache Consistency: ~ enable 


The processors available for test are listed here. The multi-processing test can be 


Conligaralons enabled/disabled for individual processors on this menu. The enable/disable tog- 
gle switch next to each processor is set by clicking the left mouse button on the 
arrow circle. Subtests There are no subtest currently supported by this test. 
Options The following options can be run singly or concurrently. 

Subtests No subtests are currently supported. 

Options The following options are available for mptest: 

Each processor uses the SPARC atomic instruction 1dstub as a lock/unlock to 

Lock/Unlock : j ‘ : ; 
write to a shared physical memory page. While one processor is attempting the 
write, the other processors are free spinning for their turn to write. 

Each processor, in turn, writes data to the disk. The other processors immedi- 

Data I/O : 
ately read and verify the data pattern. 

FPU Consistency The processors under test do floating point and integer numeric computations 


simultaneously, and verify identical results. 


This option requires two or more processors to access the same physical address. 
This option verifies that a change in physical address by one processor is 
confirmed by another. 


Cache Consistency 
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Command-line Syntax 


Ro 


Sundiag mptest can be run from a SunView window or a TTY port; mptest 
can run from the command line using the following syntax: 


/usr/diag/sundiag/mptest T=n C=n M=x standard_arguments 


Insert arguments for T, C, and M from the following table; see the Sundiag 2.3 
User’s Guide - SunOS 4.1.2 for a description of standard_arguments. 


Argument Description 


T=n nis one of the following integers, representing the bit pattern of 
the test options to be enabled. If T= is not specified, the default is 
to enable all options 
1 = Shared Memory Enabled 
2 = Data I/O Enabled 
3 = Data I/O and Shared Memory Enabled 
4 = FPU Check Enabled 
5 = FPU Check and Shared Memory Enabled 
6 = FPU Check and Data I/O Enables 
7 = FPU Check, Data I/O, and Shared Memory Enabled 
8 = Cache Consistency Enabled 
9 = Cache Consistency and Shared Memory Enabled 
10 = Cache Consistency and Data I/O Enabled 
11 = Cache Consistency, Data I/O, and Shared Memory Enabled 
12 = Cache Consistency and FPU Chick Enabled 
13 = Cache Consistency, FPU Check, and Shared Memory Enabled 
14 = Cache Consistency, FPU Check, and Data I/O Enabled 
15 = Cache Consistency, FPU Check, Data I/O, and Shared 
Memory Enabled. 


C=n nis one of the following integers, representing the bit pattern of 
the processors to be enabled. If C= is not specified, the default is 
to enable all available processors. 

1 = processor0 Enabled 

2 = processor! Enabled 

3 = processor2 Enabled 

4 = processor3 Enabled 

5 = processor0 and processor3 Enabled 

6 = processor1l and processor2 Enabled 

7 = processor0, processorl, and processor2 Enabled 
8 = processor3 Enabled 

9 = processor0 and processor3 Enabled 

10 = processor! and processor3 Enabled 

11 = processor0, processor1, and processor3 Enabled 
12 = processor2 and processor3 Enabled 

13 = processor0, processor2, and processor3 Enabled 
14 = processor1, processor2, and processor3 Enabled 
15 = processor0, processor1, processor2, and processor3 Enabled 

M=x x is the test pattern expressed as a hexadecimal number. The range 
is from 0 to Oxff. The default is 0x10. 
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C.2. Error mptest may return one of the following error messages. These messages 
specify problem with specific command-line arguments: 


ERROR: Must be super-user 
User is not in super-user mode. 


Cannot open <file> 
The disk is full. The Data I/O test file can not create a /tmp 
directory, or open it if it exists. 


Couldn’t map address space to device, <system error 
message> 

The mmap process, which maps the Data I/O test file to memory, has 
failed. 


Fail get share memory, <error number> 
Failure to get the shared memory segment. 


Fail to fork! 
A new process could not be spawned. 


Fail <single/double> precision FPU test, process 
<number>, processor <number>, observed = <pattern>, 
expected = <pattern> 

FPU test failed on a specify process, and processor. 


Fail to open /dev/kmem 
/dev/kmem could not be opened for Cache Consistency. 


Fail to open /dev/mem 
/dev/mem could not be opened for Cache Consistency. 


Toctl error, errno = <number>, sys_errlist = <error 
message> 
The kernel support ioctl failed. 


Please specify the ‘T=’ argument again 
The integer specified for the "T=n" argument was not acceptable; 
enter another 


Please specify the ‘C=n’ argument again 
The integer specified for the "C=n" argument was not acceptable; 
enter another. 


Can not run Multi-Processors test! You need to 
enable at least two processors. 
There was an error in the non Multi-Processors environment. Add 
another processor from the mpt est Option Menu, or by using the 
"C=n" option. 


S 
Ro sun Revision A of December 1991 


microsystems 


C-6 SunOS 4.1.2 Release Manual 


eo SUN Revision A of December 1991 


microsystems 


X/Open Conformance Statement (XCS- 
QUE-3.106) 


This appendix provides the X/Open Conformance Statement for all Sun and 
Sun-based software products that have received the XPG3 Component brand. 
X/Open’s publication procedure prints the conformance statement as a series of 
chapters, one for each component. Each component is assigned a specific chapter 
number. This appendix starts with the conformance statement for the Commands 
and Utilities component, which X/Open assigns to Chapter 3. The following 
XCS-QUE-3.106 conformance chapters are printed here: 


e Chapter 3: Commands and Utilities 

e Chapter 4: C Language 

e Chapter 5: Indexed Sequential Access Method 

e Chapter 8: Pascal Language 

e Chapter 9: Fortran Language 

e Chapter 10: SQL 

e Chapter 11: Terminal Interfaces 

e Chapter 12: Window Management 

e Chapter 14: Inter-Process Communication 

e Chapter 15: Source Code Transfer 

e Chapter 16-1: Ada Language (from Telesoft AB) 
e Chapter 16-2: Ada Language (from Verdix Corporation) 
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PRODUCT IDENTIFICATION 


CONFORMANCE 
REFERENCE 


ENVIRONMENT 
SPECIFICATION 


CONFORMANCE 
EXPECTATIONS 


Chapter 3: COMMANDS AND UTILITIES 


Product Identification SunOS 
Version/Release No. 4, from 4.1 on 


If you do not supply this component yourself, please identify below the supplier 
you reference. 


Indicator of Compliance 
None 


Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 


SunOS 4.1 running on a Sun4 


Volume | of XPG3 recognises that convergence of implementations towards a 
common specification for commands and utilities is not yet complete and there- 
fore does not require a vendor to supply all of the commands and utilities (and 
individual options) specified in XPG3. 


This chapter explicitly identifies those commands and utilities not supplied by 
the vendor and any supplied which do not conform to the published specification. 
(Reference : XPG3 Volume 1 Page 1). 
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3.1.1 SUPPORTED 
COMMANDS 


3.1.2 COMMAND BEHAVIOR 


Section 3.1: BASIC UTILITIES 


Question 1: Which of the basic utilities (non-development utilities) defined in 
the XPG are not provided with the implementation? 


Answer: 


The iconv, mailx and mkfifo commands are not provided. 


Rationale 


The XPG Volume | states that “‘this volume in its current form is useful 
only as a guide to portability, but it is not possible to precisely define or test 
conformance to it’’. This question determines whether or not the implemen- 
tation provides a command of the name specified in the XPG, it does not 
attempt to determine whether it supports the semantics of that command. 
The (optional) development utilities are excluded from this question and are 
dealt with in the next section of the questionnaire. 


Reference 


XPG3 Volume | Page 1 - Introduction 


Question 2: In what ways do the commands provided by the implementation 
behave differently from the specifications contained in the XPG? 


Answer: 


Command Behaviour Differences from XPG3 


at Uses /var/spool/cron/* instead of /usr/lib/cron/* 
batch Uses /var/spool/cron/* instead of /usr/lib/cron/* 
crontab Uses /var/spool/cron/* instead of /usr/lib/cron/* 
awk Not completely 8-bit clean 

pack Accepts file names up to 12 bytes long 

sh The ulimit built-in is not provided 


Rationale 


This question provides a greater degree of granularity than the previous 
question, requiring the semantic differences associated with the commands 
to be specified. Again, the question relates to the basic utilities rather than 
the development utilities. The question only relates to the semantics of the 
options specified within the XPG; implementation specific extensions should 
not be documented. 


SS 
RD sun Revision A of December 1991 


microsystems 


D-4 SunOS 4.1.2 Release Manual 


Section 3.2; DEVELOPMENT UTILITIES 


3.2.1 SUPPORTED Question 3: Which of the development utilities defined in the XPG are not pro- 
COMMANDS vided with the implementation? 
Answer: 


The optional dis and sdb utilities are not provided. 
Rationale 


The XPG Volume | states that ‘“The development utilities might not be 
present in all X/Open compliant systems; in designated (DEVELOPMENT) 
systems all of the development utilities must be present and must conform to 
the published definition’’. 


Reference 
XPG3 Volume 1 Page 2 - Status of Interfaces 
3.2.2 COMMAND BEHAVIOR Question 4: Jn what ways do the development utilities provided by the imple- 
mentation behave differently from the specifications contained in the XPG? 


Answer: 


Command Option Behaviour Differences from XPG3 


admin -alname Not supported 
-fi[str] Optional string argument not supported 
-filist Does not provide all generality specified by XPG3 


cc -f Requires option argument specifying type of 
floating point support to be provided 

lex Not 8-bit clean 

lint -o LIB Creates library with name llib-ILIB.In 


as in all known historical implementations 
instead of with name LIB as specified by XPG3 


make Search order for makefiles is 
makefile, SCCS/s.makefile, Makefile, SCCS/s.Makefile 
instead of makefile, Makefile, s.makefile, s.Makefile 


nm -e Not supported 
-f Not supported 


Rationale 


This question provides a greater degree of granularity than the previous 
question, requiring the semantic differences associated with the development 
utilities to be specified. 
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3.3.1 COMMANDS AND 


Command 


ar 


awk 


comm 
cp,In,mv 


cpio 


date 
ed,red 


egrep 


expr 


fgrep 


find 


grep 


join 


Ipstat 
Is 


Section 3.3: INTERNATIONALISATION OPTION 


Question 5: /s an internationalised environment, reflecting changes in the 
locale setting as described in XPG Volume 1 - XSI Commands and Utilities, 


supported? 


Answer: 


Sun does not claim support for internationalised commands and utilities in 
SunOS 4, although the following table does indicate that some of the options 


described in XPG3 are supported in this release. 


Behaviour Specified in XPG3 


LC_TIME affects date format 


LC_COLLATE, LC_CTYPE affect regular expression matching 
LC_COLLATE affects the behaviour of string comparisons 
LC_NUMERIC affects the behaviour of the radix character 


LC_COLLATE affects sorting sequence 
LANG affects yes string 


LC_COLLATE, LC_CTYPE affect filename pattern matching 
LC_TIME affects date format 


LC_TIME affects date formatting options 


LC_COLLATE, LC_CTYPE affect regular expression matching 
LC_CTYPE is used to determine whether characters are printable 


LC_COLLATE, LC_CTYPE affect regular expression matching 
LC_CTYPE is used to determine character classification 
(alphabetic, upper-case, lower case) 


LC_COLLATE, LC_CTYPE affect regular expression matching 
LC_COLLATE affects the behaviour of relational operators 


LC_CTYPE is used to determine character classification 
(alphabetic, upper-case, lower case) 


LANG affects yes string 
LC_COLLATE, LC_CTYPE affect filename pattern matching 


LC_COLLATE, LC_CTYPE affect regular expression matching 
LC_CTYPE is used to determine character classification 
(alphabetic, upper-case, | to discower case) 


LC_COLLATE affects sorting sequence 
LC_TIME affects date format 


LC_COLLATE affects sorting sequence 
LC_CTYPE is used to determine whether a character is printable 
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Command 


mail 


mailx 


Ps 
pr 


ps 
rm,rmdir 


sed 


sh 


sort 


tar 


tr 


uniq 
uucp 
uustat 
wc 
who 


yacc 


Behaviour Specified in XPG3 
LC_TIME affects date format 
LC_TIME affects date format 


LC_COLLATE, LC_CTYPE affect filename pattern matching 
LC_TIME affects date format 


LC_COLLATE, LC_CTYPE affect filename pattern matching 


LC_TIME affects date format 
LC_CTYPE is used to determine whether a character is printable 


LC_TIME affects date format 
LANG affects yes string 


LC_COLLATE, LC_CTYPE affect regular expression matching 
LC_CTYPE is used to determine whether a character is printable 


LC_COLLATE, LC_CTYPE affect filename pattern matching 
LC_CTYPE is used to determine whether a character is alphabetic 


LC_COLLATE affects sorting sequence 

LC_CTYPE affects character classification (alphabetic, upper 
case, printing) 

LC_NUMERIC affects the determination of the radix character 


LC_TIME affects date format 
LANG affects yes string 


LC_COLLATE, LC_CTYPE affect bracketed expressions 
LC_CTYPE affects the definition of the character universe 


LC_COLLATE affects sorting sequence 

LC_TIME affects date format 

LC_TIME affects date format 

LC_CTYPE is used to determine white-space characters 
LC_TIME affects date format 


LC_CTYPE is used to determine character classification 


Rationale 


Supported 


This behaviour is collectively optional; that is, it should be provided for all 
commands listed (subject to sections 3.1 and 3.2, which identify those com- 
mands not supplied by the vendor and those which do not fully support the 


X/Open specification). 
Reference 


XPG3 Volume | Pages 4-5 - Status of Interfaces. 
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3.3.2 REGULAR Question 6: Which form of regular expression syntax is supported by those com- 
EXPRESSIONS IN mands which use regular expressions? 
COMMANDS 

Answer: 


Command Regular Expression Syntax Supported 


awk Extended 
csplit Simple 
ed Simple 
egrep Extended 
ex Simple 
expr Simple 
grep Simple 
lex Extended 
pg Simple 
sed Simple 
Vi Simple 
Rationale 


The XPG Volume 3 - XSI Supplementary Definitions requires that an inter- 
nationalised set of commands will provide regular expression syntax for the 
above commands in one of the forms specified for that command. The XPG 
encourages the implementation of internationalised regular expressions for 
all of the above utilities. It should be noted that the sdb command is an 
optional development utility and may not be available on all XPG conform- 
ing systems. 


Reference 


XPG3 Volume 3 Pages 49-51 - Regular Expressions 
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Chapter 4: C LANGUAGE 


, 


PRODUCT IDENTIFICATION product Identification _ C compiler bundled with SunOS 


Version/Release No. 4, from 4.1 on 


If you do not supply this component yourself, please identify below the supplier 
you reference. 


CONFORMANCE Indicator of Compliance 
BEEESENE VSX Test Suite Release 3.203 
Testing Agency Name Sun Microsystems 
Address 2550 Garcia Avenue 
Mountain View CA 94043 
ENVIRONMENT Enter below details of the hardware and software environment in which testing 
SPECIFICATION took place, including compilation routines and installation procedures (if any). 


Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 


SunOS 4.1 running on a Sun4 


TEMPORARY WAIVERS List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail- 
able with this document on request. 


4.1 IMPLEMENTATION Question 1: What limits does the implementation impose on the significant part 
LIMITS of a identifier? 
Answer: 
External identifiers 32 characters 


Non-External identifiers 127 characters 


Rationale 


The XPG states that, while there is no limit to the length of an identifier, 
only a certain number of characters are significant. The XPG points out that 
there must be at least eight characters for a non-external name, but may be 
less for external names. 


Reference 


XPG 3 Volume 4 Page 3 - Lexical Conventions 
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4.2 GENERAL 


@ 


Question 2: What truncation rules are applied when a floating value is con- 
verted to an integral value? 


Answer: 
Truncation of floating point values is always towards zero. 
Rationale 


The XPG states that such conversions are machine dependent. In particular, 
the XPG points out the differences related to the truncation of negative 
numbers. 


Reference 
XPG Volume 4 Page 10 - Conversions 


Question 3: What truncation rules are applied when using the division operator 
and either of the operands is negative? 


Answer: 

Truncation towards zero 
Rationale 

The XPG states that such truncations are machine dependent. 
Reference 


XPG Volume 4 Page 16 - Expressions 
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PRODUCT IDENTIFICATION 


CONFORMANCE 
REFERENCE 


ENVIRONMENT 
SPECIFICATION 


TEMPORARY WAIVERS 


5.1 IMPLEMENTATION 
LIMITS 


Chapter 5: INDEXED SEQUENTIAL ACCESS METHOD 


Product Identification NetISAM 

Version/Release No. 1.0 and subsequent releases 

If you do not supply this component yourself, please identify below the supplier 
you reference. 

Indicator of Compliance 


VSX Test Suite Release 3.201 


Testing Agency Name Sun Microsystems 
Address 2550 Garcia Avenue 
Mountain View CA 94043 


Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 


SunOS 4.1 running on a Sun4 

List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail- 


able with this document on request. 


Question 1: What limits does the implementation impose for the following 


aspects ? 
Answer: 
Number of key parts in an index NPARTS 8 
Maximum size of a key MAXKEYSIZE 150 
Maximum number of indices per file — 16 
Maximum size of data record — 8192 
Maximum number of concurrently locked records — 5000 
Maximum number of ISAM files that can be 

concurrently open — 128 
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e 


Rationale 


The XPG states that the values for NPARTS and MAXKEYSIZE are imple- 
mentation specific but must be at least 8 and 120 respectively. The XPG 
states that the definition puts no limit on the number of alternative indices 
that can be created for a file. However, it is known that some implementa- 
tions impose a limit rather than allowing for a potentially infinite number of 
indices. The XPG also remains silent about the maximum length of a data 
record, though it is again known that some implementations impose a limit. 
The XPG states that the number of records that may be concurrently locked 
when a file has been opened with ISIMANULOCK set is system dependent. 
This number may depend on the locks that are concurrently applied to other 
files and the number specified in the answer should be the maximum number 
of concurrently locked records that could be attained. The XPG states that an 
application program must be able to have at least ten ISAM files con- 
currently open. This limit assumes that the process has no other files open. 
The limit given in answer to the above question must also be based upon this 
assumption. 


Reference 


XPG 3 Volume 5 Page 61 - The <isam.h> Header 
XPG 3 Volume 5 Page 7 - ISAM Overview 

XPG 3 Volume 5 Page 20 - Manual Record Locking 
XPG 3 Volume 5 Page 71 - Files. 
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PRODUCT IDENTIFICATION 


CONFORMANCE 
REFERENCE 


ENVIRONMENT 
SPECIFICATION 


TEMPORARY WAIVERS 


Ge 


S 


Chapter 8: PASCAL LANGUAGE 


Product Identification Sun Pascal 
Version/Release No. 2.0 and subsequent releases 


If you do not supply this component yourself, please identify below the supplier 
you reference. 


Indicator of Compliance 
NIST Test Suite Release 5.1 
Testing Agency Name NIST 
Address Gaithersburg, MD 
NIST Certificate Number NIST-89/2663 


Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 


SunOS 4.0 on a Sun4 


List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail- 
able with this document on request. 


A temporary waiver has been granted for Sun Pascal, because the NIST testing 
was performed on SunOS 4.0 rather than SunOS 4.1. The waiver is granted until 
December 6, 1991. The X/Open reference number on the waiver request is: 


PG3.083 
The waiver request follows: 


Pascal is not tested by VSX; instead, X/Open accepts a NIST certificate as 
the indicator of compliance. As the Trade Mark License Agreement is writ- 
ten, the NIST certificate must be from a test run on a system that is XPG 
branded. We have a NIST certificate from a test run on a version of the 
operating system prior to the version that will be XPG branded. 


We are requesting a temporary waiver for the Pascal component because the 
NIST certificate for our Pascal product is from a test run on a version of the 

operating system prior to the version that will be XPG branded. The Pascal 

product executes correctly on either version of the operating system; that is, 
the identical binary image of the Pascal compiler works correctly on the 
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version of the operating system that NIST used to run their tests, and on the 
version of the operating system that will be XPG branded. This testing 
discrepancy has zero impact on application portability. Note that this tem- 
porary waiver is removed not by fixing the product, but by asking NIST to 
re-test the product on the version of the operating system with the XPG 
brand. 


For example, suppose that Acme Computers had earned an XPG brand for 
ACME O/S 6.3, but had asked NIST to test ACME PASCAL on ACME O/S 
6.2 (which does not have an XPG brand). Acme Computers would not be 
able to get an XPG brand for ACME PASCAL until NIST re-tested the com- 
piler on ACME O/S 6.3. Since the identical binary image of ACME PAS- 
CAL runs on both ACME O/S 6.2 and ACME O/S 6.3, it is clear that the 
lack of the XPG brand for ACME PASCAL does NOT reflect product qual- 
ity, but only the order in which testing was planned. Therefore, Acme Com- 
puters would request a temporary waiver allowing them to use the XPG 
brand on ACME PASCAL until such time as NIST completed the re-test of 
ACME PASCAL on ACME OSS 6.3. 
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Chapter 9: FORTRAN LANGUAGE 


PRODUCT IDENTIFICATION Product Identification Sun Fortran 


Version/Release No. 1.3 and subsequent releases 


If you do not supply this component yourself, please identify below the supplier 
you reference. 


CONFORMANCE Indicator of Compliance 

REECE NIST Test Suite Release 2.0 
Testing Agency Name NIST 
Address Gaithersburg, MD 
NIST Certificate Number NIST-89/2004 


ENVIRONMENT Enter below details of the hardware and software environment in which testing 

SPECIFICATION took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 


SunOS 4.0 running on a Sun4 


TEMPORARY WAIVERS List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail- 
able with this document on request. 


A temporary waiver has been granted for Sun Fortran, because the NIST testing 
was performed on SunOS 4.0 rather than SunOS 4.1. The waiver is granted until 
December 6, 1991. The X/Open reference number on the waiver request is: 


PG3.084 
The waiver request follows: 


Fortran is not tested by VSX; instead, X/Open accepts a NIST certificate as 
the indicator of compliance. As the Trade Mark License Agreement is writ- 
ten, the NIST certificate must be from a test run on a system that is XPG 
branded. We have a NIST certificate from a test run on a version of the 
operating system prior to the version that will be XPG branded. 


We are requesting a temporary waiver for the Fortran component because 
the NIST certificate for our Fortran product is from a test run on a version of 
the operating system prior to the version that will be XPG branded. The 
Fortran product executes correctly on either version of the operating system; 
that is, the identical binary image of the Fortran compiler works correctly on 
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the version of the operating system that NIST used to run their tests, and on 
the version of the operating system that will be XPG branded. This testing 
discrepancy has zero impact on application portability. Note that this tem- 
porary waiver is removed not by fixing the product, but by asking NIST to 
re-test the product on the version of the operating system with the XPG 
brand. 


For example, suppose that Acme Computers had earned an XPG brand for 
ACME O/S 6.3, but had asked NIST to test ACME FORTRAN on ACME 
O/S 6.2 (which does not have an XPG brand). Acme Computers would not 
be able to get an XPG brand for ACME FORTRAN until NIST re-tested the 
compiler on ACME O/S 6.3. Since the identical binary image of ACME 
FORTRAN runs on both ACME O/S 6.2 and ACME O/S 6.3, it is clear that 
the lack of the XPG brand for ACME FORTRAN does NOT reflect product 
quality, but only the order in which testing was planned. Therefore, Acme 
Computers would request a temporary waiver allowing them to use the XPG 
brand on ACME FORTRAN until such time as NIST completed the re-test 
of ACME FORTRAN on ACME O/S 6.3. 
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PRODUCT IDENTIFICATION 


CONFORMANCE 
REFERENCE 


ENVIRONMENT 
SPECIFICATION 


TEMPORARY WAIVERS 


Chapter 10: SQL 


Product Identification Informix OnLine 
Version/Release No. 4.0 


If you do not supply this component yourself, please identify below the supplier 
you reference. 


Informix Software Inc 
4100 Bohannon Drive 
Menlo Park CA 94025 


Indicator of Compliance 
None 


Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 


SunOS 4.1 running on a Sun4 


List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail- 
able with this document on request. 
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PRODUCT IDENTIFICATION 


CONFORMANCE 
REFERENCE 


ENVIRONMENT 
SPECIFICATION 


TEMPORARY WAIVERS 


S 


Chapter 11: TERMINAL INTERFACES 


Product Identification SunOS 
Version/Release No. 4, from 4.1 on 


If you do not supply this component yourself, please identify below the supplier 
you reference. 


Indicator of Compliance 
None 


Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 


SunOS 4.1 running on a Sun4 


List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail- 
able with this document on request. 
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Chapter 12: WINDOW MANAGEMENT 


a ea al Product Identification | OpenWindows 
Version/Release No. 1.0 and subsequent releases 
If you do not supply this component yourself, please identify below the supplier 
you reference. 

CONFORMANCE Indicator of Compliance 

REFERENCE None 

ENVIRONMENT : Enter below details of the hardware and software environment in which testing 

SPECIFICATION took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 
SunOS 4.1 running on a Sun4 

TEMPORARY WAIVERS List below references to any temporary waivers granted by X/Open in respect of 


minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail- 
able with this document on request. 
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PRODUCT IDENTIFICATION 


CONFORMANCE 
REFERENCE 


ENVIRONMENT 
SPECIFICATION 


TEMPORARY WAIVERS 


S 
w 


Chapter 14: INTER-PROCESS COMMUNICATION 


Product Identification SunOS 
Version/Release No. 4, from 4.1 on 


If you do not supply this component yourself, please identify below the supplier 
you reference. 


Indicator of Compliance 
None 


Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 


SunOS 4.1 running on a Sun4 


List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail- 
able with this document on request. 
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15.1 UTILITIES 


Chapter 15: SOURCE CODE TRANSFER 


PRODUCT VENTING ATION Product Identification SunOS 
Version/Release No. 4, from 4.1 on 
If you do not supply this component yourself, please identify below the supplier 
you reference. 
CONFORMANCE Indicator of Compliance 
REFERENCE None 
ENVIRONMENT Enter below details of the hardware and software environment in which testing 
SPECIFICATION took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 
For Source Code Transfer software: 
SunOS 4.1 running on a Sun4 
For floppy disk hardware: 
SPARCstation with internal floppy disk drive (part number X554H) or with 
external floppy disk subsystem (part number 550D-S) 
For magnetic tape hardware: 
SPARCserver Office server or Datacenter server (Sun 4/260, Sun 4/280, Sun 
4/390 or Sun 4/490) with 1/2-inch tape drive subsystem (part number 675A) 
TEMPORARY WAIVERS List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail- 
able with this document on request. 
FORMATS Question 1: Which exchange media format(s) may be written by the system? 
Answer: 
80 track floppy disk Yes 
AO track floppy disk No 
1600bpi PE magnetic tape Yes 
sS 
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UTILITIES 


Rationale 


XPG3 states that standards are referenced for transfer of floppy discs and 
magnetic tapes between machines. Because of the different nature of 
X/Open conformant systems, it is not possible to define a single portable 
medium which is supported across the whole range of systems. 


Reference 
XPG3 Volume 3 Chapters 15, 16 and 17 


Question 2: Which exchange media format(s) may be read by the system? 


Answer: 
80 track floppy disk Yes 
40 track floppy disk No 


1600bpi PE magnetic tape Yes 


Rationale 


XPG3 states that standards are referenced for transfer of floppy discs and 
magnetic tapes between machines. Because of the different nature of 
X/Open conformant systems, it is not possible to define a single portable 
medium which is supported across the whole range of systems. In addition, 
some systems can read a wider range of formats that they can write. 


Reference 
XPG3 Volume 3 Chapters 15, 16 and 17 


Question 3: Which utilities are used to create and read the archive formats 
specified in XPG Volume 3 - XSI Supplementary Definitions ? 


Answer: 
Format Creating Reading 
Extended tar pax pax 
Cpio pax and cpio _— pax and cpio 
Rationale 


There is no explicit definition as to the commands that must be used to 
create and retrieve these archives. On most systems this will be achieved by 
the tar and cpio commands. There are other commands available which pro- 
duce these archives. On some implementations the command may need a 
special option to enable reading of the specified formats with the ‘‘standard’’ 
option being to create archives which are backwards compatible with previ- 
ous versions of the command. 


Reference 
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INVALID FILE NAMES 


MULTI VOLUME ARCHIVES 


@ 


XPG3 Volume 3 Chapter 18 


Question 4: What file name is used to contain data from the archive in the case 
that the file name on the archive is invalid for the system on which the file hierar- 
chy is being created? 


Answer: 


Format File Name 


Extended tar _All legal file names in a USTAR archive are legal in the filesystem. 


Cpio All legal file names in a cpio archive are legal in the filesystem. 


Rationale 


Because an archive can contain non-portable file names it is necessary for an 
archive reading utility to be able to generate a file and store the data associ- 
ated with a non-portable file name when this is encountered on the archive. 
There may be a need to generate a number of such file names in the same 
directory and the specification should detail the algorithm used to generate 
these file names. 


Reference 


XPG3 Volume 3 Pages 151,155 


Question 5: How does the archive reading utility determine which file to read as 
the next volume when an end-of-file or end-of-media condition is encountered? 


Answer: 


Format Method 


Extended tar The pax utility prompts the user for the pathname of the 
next file in the archive. (The path need not name a device.) 


Cpio The cpio and pax utilities prompt the user for the pathname of 
the next file in the archive. (The path need not name a device.) 
Options: 
Description of method used by each utility. 


Refer to: POSIX.1 Conformance Document Section 10.1.3. 
Rationale: 


In many cases the utility will prompt the user for the path name of the device 
to use for the next volume. There may be extensions to the utility syntax 
which allow the definition of alternate addresses for subsequent volumes. 


S u n Revision A of December 1991 


microsystems 


Appendix D — X/Open Conformance Statement (XCS-QUE-3.106) | D-23 


Chapter 16: ADA LANGUAGE 


ERODE eee Product Identification | TeleGen2 Ada Development System 


Version/Release No. 1.4 


If you do not supply this component yourself, please identify below the supplier 
you reference. 


TeleSoft 
CONTACT: Joan Giannetta 
5959 Cornerstone Court West 


San Diego CA 92121 
CONFORMANCE Indicator of Compliance 
See ee ADA Joint Program Office 
Test Suite Release 1.10 
Testing Agency Name Wright-Patterson AFB Ada Validation Facility 
Address Wright-Patterson Air Force Base 
Dayton OH 
ADA Joint Program Office 
Certificate Number 890801 W 1.10134 
ENVIRONMENT Enter below details of the hardware and software environment in which testing 
SPECIFICATION took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 
SunOS 4.0 running on a Sun4 
TEMPORARY WAIVERS List below references to any temporary waivers granted by X/Open in respect of 


minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail- 
able with this document on request. 


A temporary waiver has been granted for TeleSoft TeleGen2, because the AJPO 
testing was performed on SunOS 4.0 rather than SunOS 4.1. The waiver is 
granted until December 6, 1991. The X/Open reference number on the waiver 
request is: 


PG3.085 
The waiver request follows: 


Ada is not tested by VSX; instead, X/Open accepts an AJPO certificate as 
the indicator of compliance. As the Trade Mark License Agreement is 
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written, the AJPO certificate must be from a test run on a system that is XPG 
branded. We have an AJPO certificate from a test run on a version of the 
operating system prior to the version that will be XPG branded. 


We are requesting a temporary waiver for the Ada component because the 
AJPO certificate for our Ada product is from a test run on a version of the 
operating system prior to the version that will be XPG branded. The Ada 
product executes correctly on either version of the operating system; that is, 
the identical binary image of the Ada compiler works correctly on the ver- 
sion of the operating system that AJPO used to run their tests, and on the 
version of the operating system that will be XPG branded. This testing 
discrepancy has zero impact on application portability. Note that this tem- 
porary waiver is removed not by fixing the product, but by asking AJPO to 
re-test the product on the version of the operating system with the XPG 
brand. 


For example, suppose that Acme Computers had earned an XPG brand for 
ACME O/S 6.3, but had asked AJPO to test ACME ADA on ACME O/S 6.2 
(which does not have an XPG brand). Acme Computers would not be able 
to get an XPG brand for ACME ADA until AJPO re-tested the compiler on 
ACME O/S 6.3. Since the identical binary image of ACME ADA runs on 
both ACME O/S 6.2 and ACME O/S 6.3, it is clear that the lack of the XPG 
brand for ACME ADA does NOT reflect product quality, but only the order 
in which testing was planned. Therefore, Acme Computers would request a 
temporary waiver allowing them to use the XPG brand on ACME ADA until 
such time as AJPO completed the re-test of ACME ADA on ACME O/S 6.3. 
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Product Identification | Verdix Ada Development System VAda-110-4040 


Version/Release No. 6.0 


If you do not supply this component yourself, please identify below the supplier 
you reference. 


Verdix Corporation 
CONTACT: Roger Baker 
14130-A Sullyfield Circle 
Chantilly VA 22021 


Indicator of Compliance 


ADA Joint Program Office 
Test Suite Release 1.10 
Testing Agency Name Wright-Patterson AFB Ada Validation Facility 
Address Wright-Patterson Air Force Base 
Dayton OH 
ADA Joint Program Office 
Certificate Number 890216W1.10030 


Enter below details of the hardware and software environment in which testing 
took place, including compilation routines and installation procedures (if any). 
Sufficient detail must be supplied to enable conformant behaviour and any test 
results to be reproduced. 


SunOS 4.0 running on a Sun4 


List below references to any temporary waivers granted by X/Open in respect of 
minor errors in the product referenced above. This should include the X/Open 
reference and the waiver expiry date. The waivers as granted shall be made avail- 
able with this document on request. 


A temporary waiver has been granted for Verdix VADS, because the AJPO test- 
ing was performed on SunOS 4.0 rather than SunOS 4.1. The waiver is granted 
until December 6, 1991. The X/Open reference number on the waiver request is: 


PG3.085 


The waiver request follows: 


Ada is not tested by VSX; instead, X/Open accepts an AJPO certificate as 
the indicator of compliance. As the Trade Mark License Agreement is writ- 
ten, the AJPO certificate must be from a test run on a system that is XPG 
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branded. We have an AJPO certificate from a test run on a version of the 
operating system prior to the version that will be XPG branded. 


We are requesting a temporary waiver for the Ada component because the 
AJPO certificate for our Ada product is from a test run on a version of the 
operating system prior to the version that will be XPG branded. The Ada 
product executes correctly on either version of the operating system; that is, 
the identical binary image of the Ada compiler works correctly on the ver- 
sion of the operating system that AJPO used to run their tests, and on the 
version of the operating system that will be XPG branded. This testing 
discrepancy has zero impact on application portability. Note that this tem- 
porary waiver is removed not by fixing the product, but by asking AJPO to 
re-test the product on the version of the operating system with the XPG 
brand. 


For example, suppose that Acme Computers had earned an XPG brand for 
ACME OSS 6.3, but had asked AJPO to test ACME ADA on ACME OSS 6.2 
(which does not have an XPG brand). Acme Computers would not be able 
to get an XPG brand for ACME ADA until AJPO re-tested the compiler on 
ACME O/S 6.3. Since the identical binary image of ACME ADA runs on 
both ACME O/S 6.2 and ACME O/S 6.3, it is clear that the lack of the XPG 
brand for ACME ADA does NOT reflect product quality, but only the order 
in which testing was planned. Therefore, Acme Computers would request a 
temporary waiver allowing them to use the XPG brand on ACME ADA until 
such time as AJPO completed the re-test of ACME ADA on ACME OSS 6.3. 
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FORTRAN 1.2, installation of 
compatibility with SunOS release 4.1.2, 7-15 


A 
about SPARCsystem 600MP systems, 2-6 
add_client command 
if command fails, use rm_client before retrying, 10-3 
add_services command 
adding new release requires 350 KB in /usr, 10-2 
aliases in open boot PROM for device path names, 5-1 
ALM-2 serial ports in GENERIC kernel file, 8-7 
application and kernel architecture, 1-3 
application architecture, 1-3 
architecture, application and kernel, 1-3 
assembler, SPARC 
optimization level -O2 produces incorrect code, 10-9 
automounter 
may cover /home on system mounting /home from local 
disk, 10-2 
Sun386i server kit causes all clients to automount /home, 
10-18 


B 


boxes, use of, 1-5 


C 

CD-ROM 

actions causing system to hang, 10-21 

eject command may fail after read failure, 10-21 

must be at sr0 for SunInstall, 10-21 

some error messages can be disregarded, 10-22 
CG6 frame buffer 

screen errors with some SPARC 390/4X0 system PROMs, 

10-17 

compatibility of releases, 1-1 
compiler, SPARC 

incorrect code at optimization level -O2, 10-9 
conventions, documentation, 1-5 


D 
DeskSet, 3-1 
Desktop SPARCsystem 
definition, 1-4 
/home on second disk, 8-10 
rebuilding the kernel, 8-3 


Desktop SPARCsystem, continued 
swap space on second disk, 8-10 
desktop tutorial, 3-5 
devalias command, 5-6 
device driver 
for SPARCsystem 4X0, B-5 
for Sun-3/4X0, B-5 
device names 
open boot PROM, 5-4 
differences 
SunOS 4.1.1, SunOS 4.1.1 Rev B, & SunOS 4.1.2, 2-1 
disk drives 
moving from SunOS 4.1/4.1.X to system under earlier release, 
10-3 
documentation 
conventions, 1-5 
guide, 1-5 
Domain Name Service (DNS) 
hostname required in “host” files, 10-7 
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error messages 
Alignment Error, 10-13 
assertion failed panic:bn! UFS_hole, 10-18 
Bus Error, 10-13 
eject: Open fail on cd, 10-21 
fatal IO error 32 (Broken pipe), 10-23 
have you run install_cmgr?, 3-4 
Inappropriate ioctl for device, 10-23 
ld.so: libsuntool.so.0.## not found, 7-4 
Memory address not aligned, 10-14 
mount: [...] I/O error; mount: [...] giving up on, 10-8 
No label found - attempting boot anyway, 10-14 
Not enough space in sd0a, 10-2 
panic: insufficient virtual space, 10-4 
panic: data fault, 10-14 
RPC program not registered, 10-6 
rpc.cmsd is not responding..., 3-4 
sense key(0x1): soft error, 10-22 
sr0a: read recoverable, 10-22 
Su: uucico: illegal option, 10-8 
time out on RFS primary name server, 10-4 
watchdog reset, 10-18 
Watchdog Reset !, 10-4 
extract_unbundled 
problem installing software on multiple release server, 7-1 
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framebuffer 
problem redirecting I/O to ttya on SPARCstation 2 with CG6, 
10-14 
G 
guide to publications, 1-5 
H 
hierarchical device naming, 5-4 
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I/O cache, SPARCsystem 4X0, B-5 
install_cmgr command, 3-4 


K 
kadb 
causes console tty to hang, 10-5 
kernel 


and application architecture, 1-3 

architecture, 1-3 

customized for large servers, 8-6 

new configuration file for Desktop SPARCsystems, 8-3 


L 


language products, 7-11 
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machine names & system architecture, 1-3 
maxcontig parameter 
cannot be greater than 7 with tunefs -a, 10-8 
maxusers, changing value in kernel for large systems, 8-6 
memory 
8MB required by OpenWindows, 7-3 
miniroot 
can’t be booted with some SPARC 390/4X0 system PROMs, 
10-15 
sun-4/330 cannot boot from internal disk with some PROMs, 
10-14 
MP, how it works, 2-6 
multiprocessor, how it works, 2-6 


N 
NeWS (Network extensible Window System) window system, 3-1 
NeWS Toolkit, 3-1 
NSE (Network Software Environment) 
NSE Release 1.2 not usable with SunOS 4.1.2, 7-5 
NVRAM, 5-4 


O 


online desktop tutorial, 3-5 
online Openwindows tutorial, 3-5 
OPEN LOOK 
graphical user interface, 3-1 
Intrinsics Toolkit, 3-1 
open boot PROM, 4-4, 5-4 
OpenWindows, 3-1 
deskset environment, 3-1 
requires large swap partitions, 7-3 
running install_cmgr, 3-4 


Open Windows 
tutorial, 3-5 
OpenWindows 
using as default window system, 3-3 
OpenWindows window system, 7-3 
exiting window system may generate error messages, 10-23 
foreground color not reset, 10-23 
SunView libraries required, 7-4 
too large for 104MB system disk, 7-3 


P 
ports, AIM-2 serial in GENERIC kernel file, 8-7 
PROM 
open boot, 5-4 
open boot PROM, 4-4 
problem booting miniroot from internal disk on Sun—4/330, 
10-14 
some prevent booting miniroot on SPARC 390/4X0 systems, 
10-15 
publications guide, 1-5 


R 
release compatibility, 1-1 
RFS 
problem starting primary name server only, 10-4 


S 

SCSI bus 

support for five on SPARCsystem 600MP series systems, 4-4 
show-devs command, 5-5 
software features, new, 2-1 
SPARC 390/4X0 systems 

problem booting miniroot with some PROMs, 10-15 

some PROMs cause CG6 screen errors, 10-17 
SPARCprinter 

do not install SunOS 4.1 patch under 4.1.1, 7-4 
SPARCstation 1 

problem upgrading from SunOS 4.0.3 to SunOS 4.1.1, 10-13 
SPARCstation 2 

system with CG6 has problem redirecting I/O to ttya, 10-14 
SPARCsystem 600MP system description, 2-6 
Sun386i 

correction to Sun386i SunOS 4.0.2 Installation Guide, 10-21 

server kit causes all clients to automount /home, 10-18 
SunInstall 

can only find CD-ROM at sr0, 10-21 
SunLink BSC3270 

mistake in SunLink BSC3270 System Administration Guide, 

7-10 

SunOS 

differences in 4.1.1, 4.1.1 Rev B, 4.1.2, 2-1 
SunView window system 

SunView_Users category required for OpenWindows, 7-4 
swap space 

20MB required by OpenWindows, 7-3 

using a UNIX file for local swap, 10-18 
system architecture & machine names, 1-3 
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T 
ttya io command 
fails on SPARCstation 2 with CG6 frame buffer, 10-14 
tutorial 
desktop, 3-5 
OpenWindows, 3-5 
type styles, 1-5 
Type-4 national keyboard compatibility with unbundled products, 
7-15 


U 
unbundled products 
FORTRAN 1.2 compatibility, 7-15 
installation problem for client of server running different 
release, 7-1 
uucp password file problem at bootup, 10-8 


WwW 
warnings, 1-6 
window system 
NeWS, 3-1 
OpenWindows, 3-1, 7-3 
X11/NeWS, 3-1 


XxX 
X11 window system, 3-1 
X11/NeWS window system, 3-1 
XView Toolkit, 3-1 


Y 


ypinit command 
generates error message on slave server, 10-6 
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